@absolutejs/voice 0.0.22-beta.277 → 0.0.22-beta.279

package/dist/index.d.ts

@@ -53,6 +53,7 @@ export { assertVoiceProviderRoutingContractEvidence, assertVoiceProviderRoutingC
 export { assertVoiceProviderSloEvidence, buildVoiceProviderSloReport, createVoiceProviderSloRoutes, evaluateVoiceProviderSloEvidence, renderVoiceProviderSloHTML, renderVoiceProviderSloMarkdown } from './providerSlo';
 export { createVoicePhoneAgentProductionSmokeHTMLHandler, createVoicePhoneAgentProductionSmokeJSONHandler, createVoicePhoneAgentProductionSmokeRoutes, renderVoicePhoneAgentProductionSmokeHTML, runVoicePhoneAgentProductionSmokeContract } from './phoneAgentProductionSmoke';
 export { assertVoiceProductionReadinessEvidence, buildVoiceProductionReadinessGate, buildVoiceProductionReadinessReport, createVoiceProductionReadinessRoutes, evaluateVoiceProductionReadinessEvidence, renderVoiceProductionReadinessHTML, summarizeVoiceProductionReadinessGate } from './productionReadiness';
+export { acknowledgeVoiceMonitorIssue, buildVoiceMonitorRunReport, createVoiceMemoryMonitorIssueStore, createVoiceMemoryMonitorNotifierDeliveryReceiptStore, createVoiceMonitorRoutes, createVoiceMonitorWebhookNotifier, deliverVoiceMonitorIssueNotifications, muteVoiceMonitorIssue, renderVoiceMonitorHTML, renderVoiceMonitorMarkdown, resolveVoiceMonitorIssue } from './voiceMonitoring';
 export { createVoiceReadinessProfile, recommendVoiceReadinessProfile } from './readinessProfiles';
 export { assertVoiceProviderContractMatrixEvidence, assertVoiceProviderStackEvidence, buildVoiceProviderContractMatrix, createVoiceProviderContractMatrixHTMLHandler, createVoiceProviderContractMatrixJSONHandler, createVoiceProviderContractMatrixPreset, createVoiceProviderContractMatrixRoutes, evaluateVoiceProviderContractMatrixEvidence, evaluateVoiceProviderStackEvidence, evaluateVoiceProviderStackGaps, renderVoiceProviderContractMatrixHTML, recommendVoiceProviderStack } from './providerStackRecommendations';
 export { buildVoiceOpsConsoleReport, createVoiceOpsConsoleRoutes, renderVoiceOpsConsoleHTML } from './opsConsoleRoutes';
@@ -121,6 +122,7 @@ export type { VoicePhoneAgentProductionSmokeIssue, VoicePhoneAgentProductionSmok
 export type { VoiceOpsConsoleLink, VoiceOpsConsoleReport, VoiceOpsConsoleRoutesOptions } from './opsConsoleRoutes';
 export type { VoiceOpsStatus, VoiceOpsStatusLink, VoiceOpsStatusOptions, VoiceOpsStatusReport, VoiceOpsStatusRoutesOptions } from './opsStatus';
 export type { VoiceProductionReadinessAction, VoiceProductionReadinessAuditOptions, VoiceProductionReadinessAuditRequirement, VoiceProductionReadinessAuditSummary, VoiceProductionReadinessAssertionInput, VoiceProductionReadinessAssertionReport, VoiceProductionReadinessCheck, VoiceProductionReadinessGateIssue, VoiceProductionReadinessGateOptions, VoiceProductionReadinessGateProfile, VoiceProductionReadinessGateProfileSurface, VoiceProductionReadinessGateReport, VoiceProductionReadinessOpsActionHistoryOptions, VoiceProductionReadinessOpsActionHistorySummary, VoiceProductionReadinessOperationsRecordLink, VoiceProductionReadinessOperationsRecordLinks, VoiceProductionReadinessProfileExplanation, VoiceProductionReadinessProfileSurface, VoiceProductionReadinessProofSource, VoiceProductionReadinessReport, VoiceProductionReadinessRoutesOptions, VoiceProductionReadinessTraceDeliverySummary, VoiceProductionReadinessAuditDeliveryOptions, VoiceProductionReadinessAuditDeliverySummary, VoiceProductionReadinessTraceDeliveryOptions, VoiceProductionReadinessStatus } from './productionReadiness';
+export type { VoiceMonitorDefinition, VoiceMonitorEvaluation, VoiceMonitorEvaluationInput, VoiceMonitorIssue, VoiceMonitorIssueStatus, VoiceMonitorIssueStore, VoiceMonitorNotifier, VoiceMonitorNotifierDeliveryInput, VoiceMonitorNotifierDeliveryOptions, VoiceMonitorNotifierDeliveryReceipt, VoiceMonitorNotifierDeliveryReceiptStore, VoiceMonitorNotifierDeliveryReport, VoiceMonitorNotifierDeliveryResult, VoiceMonitorRoutesOptions, VoiceMonitorRun, VoiceMonitorRunOptions, VoiceMonitorRunReport, VoiceMonitorSeverity, VoiceMonitorStatus, VoiceMonitorWebhookNotifierOptions } from './voiceMonitoring';
 export type { VoiceReadinessProfileName, VoiceReadinessProfileOptions, VoiceReadinessProfileRecommendation, VoiceReadinessProfileRecommendationScore, VoiceReadinessProfileRoutesOptions } from './readinessProfiles';
 export type { VoiceProviderStackChoice, VoiceProviderStackCapabilities, VoiceProviderStackCapabilityGap, VoiceProviderStackCapabilityGapInput, VoiceProviderStackCapabilityGapReport, VoiceProviderContractCheck, VoiceProviderContractCheckStatus, VoiceProviderContractDefinition, VoiceProviderContractMatrixAssertionInput, VoiceProviderContractMatrixAssertionReport, VoiceProviderContractMatrixHandlerOptions, VoiceProviderContractMatrixHTMLHandlerOptions, VoiceProviderContractMatrixInput, VoiceProviderContractMatrixPresetOptions, VoiceProviderContractMatrixReport, VoiceProviderContractMatrixRoutesOptions, VoiceProviderContractMatrixRow, VoiceProviderStackAssertionInput, VoiceProviderStackAssertionReport, VoiceProviderStackInput, VoiceProviderStackKind, VoiceProviderStackRecommendation } from './providerStackRecommendations';
 export type { VoiceOperationsRecord, VoiceOperationsRecordAgentHandoff, VoiceOperationsRecordAuditSummary, VoiceOperationsRecordGuardrailAssertionInput, VoiceOperationsRecordGuardrailAssertionReport, VoiceOperationsRecordGuardrailDecision, VoiceOperationsRecordGuardrailFinding, VoiceOperationsRecordGuardrailSummary, VoiceOperationsRecordIntegrationEventSummary, VoiceOperationsRecordOptions, VoiceOperationsRecordOutcome, VoiceOperationsRecordProviderDecision, VoiceOperationsRecordReviewSummary, VoiceOperationsRecordRoutesOptions, VoiceOperationsRecordStatus, VoiceOperationsRecordTaskSummary, VoiceOperationsRecordTranscriptTurn, VoiceOperationsRecordTool } from './operationsRecord';

package/dist/index.js

@@ -27328,6 +27328,18 @@ var resolvePhoneAgentSmokes = async (options, input) => {
   }
   return typeof options.phoneAgentSmokes === "function" ? await options.phoneAgentSmokes(input) : options.phoneAgentSmokes;
 };
+var resolveMonitoring = async (options, input) => {
+  if (options.monitoring === false || options.monitoring === undefined) {
+    return;
+  }
+  return typeof options.monitoring === "function" ? await options.monitoring(input) : options.monitoring;
+};
+var resolveMonitoringNotifierDelivery = async (options, input) => {
+  if (options.monitoringNotifierDelivery === false || options.monitoringNotifierDelivery === undefined) {
+    return;
+  }
+  return typeof options.monitoringNotifierDelivery === "function" ? await options.monitoringNotifierDelivery(input) : options.monitoringNotifierDelivery;
+};
 var isVoiceTelephonyWebhookSecurityReport = (value) => typeof value.generatedAt === "number" && Array.isArray(value.providers) && typeof value.status === "string";
 var resolveTelephonyWebhookSecurity = async (options, input) => {
   if (options.telephonyWebhookSecurity === false || options.telephonyWebhookSecurity === undefined) {
@@ -27698,6 +27710,8 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
     providerStack,
     providerContractMatrix,
     phoneAgentSmokes,
+    monitoring,
+    monitoringNotifierDelivery,
     telephonyWebhookSecurity,
     reconnectContracts,
     bargeInReports,
@@ -27737,6 +27751,8 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
     resolveProviderStack(options, { query, request }),
     resolveProviderContractMatrix(options, { query, request }),
     resolvePhoneAgentSmokes(options, { query, request }),
+    resolveMonitoring(options, { query, request }),
+    resolveMonitoringNotifierDelivery(options, { query, request }),
     resolveTelephonyWebhookSecurity(options, { query, request }),
     resolveReconnectContracts(options, { query, request }),
     resolveBargeInReports(options, { query, request }),
@@ -27945,6 +27961,19 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
     status: phoneAgentSmokes.some((report) => !report.pass) ? "fail" : phoneAgentSmokes.length === 0 ? "warn" : "pass",
     total: phoneAgentSmokes.length
   } : undefined;
+  const monitoringSummary = monitoring ? {
+    criticalOpen: monitoring.summary.criticalOpen,
+    open: monitoring.summary.open,
+    status: monitoring.status,
+    total: monitoring.summary.total
+  } : undefined;
+  const monitoringNotifierDeliverySummary = monitoringNotifierDelivery ? {
+    failed: monitoringNotifierDelivery.summary.failed,
+    notifiers: monitoringNotifierDelivery.summary.notifiers,
+    sent: monitoringNotifierDelivery.summary.sent,
+    status: monitoringNotifierDelivery.status,
+    total: monitoringNotifierDelivery.summary.total
+  } : undefined;
   const telephonyWebhookSecuritySummary = telephonyWebhookSecurity ? {
     enabled: telephonyWebhookSecurity.summary.enabled,
     failed: telephonyWebhookSecurity.summary.failed,
@@ -28341,6 +28370,38 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
       ]
     });
   }
+  if (monitoring && monitoringSummary) {
+    checks.push({
+      detail: monitoringSummary.status === "pass" ? `${monitoringSummary.total} monitor(s) are passing with no open issues.` : `${monitoringSummary.open} monitor issue(s) open, ${monitoringSummary.criticalOpen} critical.`,
+      href: options.links?.monitoring ?? "/voice/monitors",
+      label: "Monitoring issues",
+      status: monitoringSummary.status,
+      value: `${monitoring.summary.passed}/${monitoringSummary.total}`,
+      actions: monitoringSummary.status === "pass" ? [] : [
+        {
+          description: "Open monitor issues and resolve or acknowledge customer-owned alerts before deploy.",
+          href: options.links?.monitoring ?? "/voice/monitors",
+          label: "Open monitor issues"
+        }
+      ]
+    });
+  }
+  if (monitoringNotifierDelivery && monitoringNotifierDeliverySummary) {
+    checks.push({
+      detail: monitoringNotifierDeliverySummary.status === "pass" ? `${monitoringNotifierDeliverySummary.sent} monitor notification(s) delivered.` : `${monitoringNotifierDeliverySummary.failed} monitor notification delivery failure(s).`,
+      href: options.links?.monitoringNotifierDelivery ?? "/api/voice/monitor-issues/notifications",
+      label: "Monitor notifier delivery",
+      status: monitoringNotifierDeliverySummary.status,
+      value: `${monitoringNotifierDeliverySummary.sent}/${monitoringNotifierDeliverySummary.total}`,
+      actions: monitoringNotifierDeliverySummary.status === "pass" ? [] : [
+        {
+          description: "Open monitor notification receipts and confirm webhook, Slack, email, or audit destinations are receiving issue alerts.",
+          href: options.links?.monitoringNotifierDelivery ?? "/api/voice/monitor-issues/notifications",
+          label: "Open monitor notification receipts"
+        }
+      ]
+    });
+  }
   return {
     checkedAt: Date.now(),
     checks,
@@ -28358,6 +28419,8 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
       operationsRecords: "/voice-operations",
       observabilityExport: "/voice/observability-export",
       observabilityExportDeliveries: "/api/voice/observability-export/deliveries",
+      monitoring: "/voice/monitors",
+      monitoringNotifierDelivery: "/api/voice/monitor-issues/notifications",
       opsActions: "/voice/ops-actions",
       opsRecovery: "/ops-recovery",
       phoneAgentSmoke: "/sessions",
@@ -28389,6 +28452,8 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
         total: handoffs.total
       },
       liveLatency,
+      monitoring: monitoringSummary,
+      monitoringNotifierDelivery: monitoringNotifierDeliverySummary,
       opsActionHistory,
       opsRecovery: opsRecovery ? {
         issues: opsRecovery.issues.length,
@@ -28502,6 +28567,278 @@ var createVoiceProductionReadinessRoutes = (options) => {
   }
   return routes;
 };
+// src/voiceMonitoring.ts
+import { Elysia as Elysia44 } from "elysia";
+var escapeHtml41 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+var issueIdForRun = (run) => `voice-monitor:${run.id}:${run.impactedSessions?.[0] ?? "global"}`;
+var rollupStatus4 = (runs) => runs.some((run) => run.status === "fail") ? "fail" : runs.some((run) => run.status === "warn") ? "warn" : "pass";
+var createVoiceMemoryMonitorIssueStore = (initial = []) => {
+  const issues = new Map(initial.map((issue) => [issue.id, { ...issue }]));
+  return {
+    list: () => Array.from(issues.values()).map((issue) => ({ ...issue })),
+    upsert: (issue) => {
+      const previous = issues.get(issue.id);
+      const next = previous ? {
+        ...previous,
+        ...issue,
+        createdAt: previous.createdAt,
+        status: previous.status === "resolved" || previous.status === "muted" ? previous.status : issue.status
+      } : issue;
+      issues.set(issue.id, { ...next });
+      return { ...next };
+    },
+    update: (id, patch) => {
+      const previous = issues.get(id);
+      if (!previous) {
+        return;
+      }
+      const next = { ...previous, ...patch };
+      issues.set(id, next);
+      return { ...next };
+    }
+  };
+};
+var createVoiceMemoryMonitorNotifierDeliveryReceiptStore = (initial = []) => {
+  const receipts = new Map(initial.map((receipt) => [receipt.id, { ...receipt }]));
+  return {
+    list: () => Array.from(receipts.values()).map((receipt) => ({ ...receipt })),
+    set: (id, receipt) => {
+      receipts.set(id, { ...receipt });
+      return { ...receipt };
+    }
+  };
+};
+var buildVoiceMonitorRunReport = async (options) => {
+  const checkedAt = options.now ?? Date.now();
+  const runs = await Promise.all(options.monitors.map(async (monitor) => {
+    const evaluation = await monitor.evaluate({
+      evidence: options.evidence,
+      now: checkedAt
+    });
+    return {
+      ...evaluation,
+      checkedAt,
+      description: monitor.description,
+      id: monitor.id,
+      label: monitor.label,
+      severity: monitor.severity ?? "warn",
+      windowMs: monitor.windowMs
+    };
+  }));
+  for (const run of runs) {
+    if (run.status === "pass") {
+      continue;
+    }
+    await options.issueStore?.upsert({
+      createdAt: checkedAt,
+      detail: run.detail,
+      id: issueIdForRun(run),
+      impactedSessions: [...run.impactedSessions ?? []],
+      label: run.label,
+      lastSeenAt: checkedAt,
+      monitorId: run.id,
+      operationsRecordHrefs: [...run.operationsRecordHrefs ?? []],
+      severity: run.status === "fail" ? run.severity : "warn",
+      status: "open",
+      threshold: run.threshold,
+      value: run.value
+    });
+  }
+  const issues = await options.issueStore?.list() ?? [];
+  const openIssues = issues.filter((issue) => issue.status === "open");
+  const criticalOpen = openIssues.filter((issue) => issue.severity === "critical").length;
+  return {
+    checkedAt,
+    issues,
+    runs,
+    status: criticalOpen > 0 ? "fail" : openIssues.length > 0 || rollupStatus4(runs) === "warn" ? "warn" : rollupStatus4(runs),
+    summary: {
+      acknowledged: issues.filter((issue) => issue.status === "acknowledged").length,
+      criticalOpen,
+      failed: runs.filter((run) => run.status === "fail").length,
+      muted: issues.filter((issue) => issue.status === "muted").length,
+      open: openIssues.length,
+      passed: runs.filter((run) => run.status === "pass").length,
+      resolved: issues.filter((issue) => issue.status === "resolved").length,
+      total: runs.length,
+      warned: runs.filter((run) => run.status === "warn").length
+    }
+  };
+};
+var acknowledgeVoiceMonitorIssue = async (store, id, input = {}) => store.update(id, {
+  acknowledgedAt: input.now ?? Date.now(),
+  acknowledgedBy: input.actorId,
+  status: "acknowledged"
+});
+var resolveVoiceMonitorIssue = async (store, id, input = {}) => store.update(id, {
+  resolvedAt: input.now ?? Date.now(),
+  resolvedBy: input.actorId,
+  status: "resolved"
+});
+var muteVoiceMonitorIssue = async (store, id, input = {}) => store.update(id, {
+  mutedAt: input.now ?? Date.now(),
+  mutedBy: input.actorId,
+  status: "muted"
+});
+var createVoiceMonitorWebhookNotifier = (options) => ({
+  id: options.id,
+  label: options.label ?? options.id,
+  deliver: async ({ issue }) => {
+    const response = await (options.fetch ?? fetch)(options.url, {
+      body: JSON.stringify(options.mapIssue?.(issue) ?? {
+        detail: issue.detail,
+        impactedSessions: issue.impactedSessions,
+        issueId: issue.id,
+        label: issue.label,
+        monitorId: issue.monitorId,
+        operationsRecordHrefs: issue.operationsRecordHrefs,
+        severity: issue.severity,
+        status: issue.status,
+        value: issue.value
+      }),
+      headers: {
+        "content-type": "application/json",
+        ...options.headers
+      },
+      method: "POST"
+    });
+    return {
+      detail: `HTTP ${response.status}`,
+      status: response.ok ? "sent" : "failed"
+    };
+  }
+});
+var deliverVoiceMonitorIssueNotifications = async (options) => {
+  const checkedAt = options.now ?? Date.now();
+  const statuses = new Set(options.statuses ?? ["open"]);
+  const issues = (await options.issueStore.list()).filter((issue) => statuses.has(issue.status));
+  const receipts = [];
+  for (const issue of issues) {
+    for (const notifier of options.notifiers) {
+      const result = await notifier.deliver({ issue, now: checkedAt });
+      const receipt = {
+        detail: result.detail,
+        id: `voice-monitor-notifier:${notifier.id}:${issue.id}:${checkedAt}`,
+        issueId: issue.id,
+        notifierId: notifier.id,
+        notifierLabel: notifier.label,
+        sentAt: checkedAt,
+        status: result.status
+      };
+      receipts.push(receipt);
+      await options.receiptStore?.set(receipt.id, receipt);
+    }
+  }
+  const allReceipts = options.receiptStore ? await options.receiptStore.list() : receipts;
+  const failed = allReceipts.filter((receipt) => receipt.status === "failed").length;
+  const sent = allReceipts.filter((receipt) => receipt.status === "sent").length;
+  const skipped = allReceipts.filter((receipt) => receipt.status === "skipped").length;
+  return {
+    checkedAt,
+    receipts: allReceipts,
+    status: failed > 0 ? "fail" : allReceipts.length === 0 ? "warn" : "pass",
+    summary: {
+      failed,
+      notifiers: options.notifiers.length,
+      sent,
+      skipped,
+      total: allReceipts.length
+    }
+  };
+};
+var renderVoiceMonitorMarkdown = (report) => {
+  const rows = report.runs.map((run) => `| ${run.id} | ${run.status} | ${run.severity} | ${run.value ?? ""} | ${run.threshold ?? ""} | ${run.detail ?? ""} |`).join(`
+`);
+  return `# Voice Monitor Report
+
+- Status: ${report.status}
+- Checks: ${report.summary.passed}/${report.summary.total} passing
+- Open issues: ${report.summary.open}
+- Critical open issues: ${report.summary.criticalOpen}
+
+| Monitor | Status | Severity | Value | Threshold | Detail |
+| --- | --- | --- | --- | --- | --- |
+${rows || "| none | pass | info | | | No monitors configured. |"}
+`;
+};
+var renderVoiceMonitorHTML = (report, options = {}) => {
+  const title = options.title ?? "Voice Monitors";
+  const runs = report.runs.map((run) => `<tr><td>${escapeHtml41(run.label)}</td><td class="${escapeHtml41(run.status)}">${escapeHtml41(run.status)}</td><td>${escapeHtml41(run.severity)}</td><td>${escapeHtml41(String(run.value ?? ""))}</td><td>${escapeHtml41(String(run.threshold ?? ""))}</td><td>${escapeHtml41(run.detail ?? "")}</td></tr>`).join("");
+  const issues = report.issues.map((issue) => `<li><strong>${escapeHtml41(issue.label)}</strong> <span class="${escapeHtml41(issue.status)}">${escapeHtml41(issue.status)}</span> ${escapeHtml41(issue.detail ?? "")}</li>`).join("");
+  const snippet = escapeHtml41(`app.use(createVoiceMonitorRoutes({
+  evidence,
+  issueStore,
+  monitors: [defineVoiceMonitor(...)]
+}));`);
+  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml41(title)}</title><style>body{background:#10141b;color:#f8f2df;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1100px;padding:32px}.hero,.card{background:#171f2b;border:1px solid #2e3a4b;border-radius:24px;margin-bottom:16px;padding:22px}.eyebrow{color:#93c5fd;font-weight:900;letter-spacing:.12em;text-transform:uppercase}h1{font-size:clamp(2.2rem,6vw,4.7rem);line-height:.92;margin:.2rem 0 1rem}.pill{border:1px solid #64748b;border-radius:999px;display:inline-flex;font-weight:900;margin-right:8px;padding:8px 12px}.pass{color:#86efac}.warn,.acknowledged{color:#fde68a}.fail,.open{color:#fca5a5}.resolved,.muted{color:#cbd5e1}table{border-collapse:collapse;width:100%}td,th{border-bottom:1px solid #2e3a4b;padding:12px;text-align:left;vertical-align:top}pre{background:#0c1118;border:1px solid #2e3a4b;border-radius:16px;color:#dbeafe;overflow:auto;padding:16px}</style></head><body><main><section class="hero"><p class="eyebrow">Code-owned monitoring</p><h1>${escapeHtml41(title)}</h1><p class="pill ${escapeHtml41(report.status)}">Status: ${escapeHtml41(report.status)}</p><p class="pill">Open issues: ${String(report.summary.open)}</p><p class="pill">Critical: ${String(report.summary.criticalOpen)}</p></section><section class="card"><h2>Monitor Runs</h2><table><thead><tr><th>Monitor</th><th>Status</th><th>Severity</th><th>Value</th><th>Threshold</th><th>Detail</th></tr></thead><tbody>${runs}</tbody></table></section><section class="card"><h2>Issues</h2>${issues ? `<ul>${issues}</ul>` : '<p class="pass">No monitor issues.</p>'}</section><section class="card"><p class="eyebrow">Copy into your app</p><h2><code>createVoiceMonitorRoutes(...)</code></h2><pre><code>${snippet}</code></pre></section></main></body></html>`;
+};
+var actorFromRequest = async (request) => {
+  if (!request.headers.get("content-type")?.includes("application/json")) {
+    return;
+  }
+  const body = await request.json().catch(() => {
+    return;
+  });
+  return typeof body?.actorId === "string" ? body.actorId : undefined;
+};
+var createVoiceMonitorRoutes = (options) => {
+  const path = options.path ?? "/api/voice/monitors";
+  const htmlPath = options.htmlPath === undefined ? "/voice/monitors" : options.htmlPath;
+  const issuePath = options.issuePath ?? "/api/voice/monitor-issues";
+  const notifierPath = options.notifierPath === undefined ? "/api/voice/monitor-notifications" : options.notifierPath;
+  const issueStore = options.issueStore ?? createVoiceMemoryMonitorIssueStore();
+  const receiptStore = options.receiptStore ?? createVoiceMemoryMonitorNotifierDeliveryReceiptStore();
+  const report = () => buildVoiceMonitorRunReport({
+    evidence: options.evidence,
+    issueStore,
+    monitors: options.monitors,
+    now: options.now
+  });
+  const routes = new Elysia44({
+    name: options.name ?? "absolutejs-voice-monitoring"
+  }).get(path, report).get(`${path}.md`, async () => {
+    return new Response(renderVoiceMonitorMarkdown(await report()), {
+      headers: {
+        "Content-Type": "text/markdown; charset=utf-8",
+        ...options.headers
+      }
+    });
+  }).get(issuePath, () => issueStore.list()).get(`${issuePath}/notifications`, () => receiptStore.list()).post(`${issuePath}/:id/acknowledge`, async ({ params, request }) => {
+    const issue = await acknowledgeVoiceMonitorIssue(issueStore, params.id, {
+      actorId: await actorFromRequest(request)
+    });
+    return issue ?? new Response("Issue not found", { status: 404 });
+  }).post(`${issuePath}/:id/resolve`, async ({ params, request }) => {
+    const issue = await resolveVoiceMonitorIssue(issueStore, params.id, {
+      actorId: await actorFromRequest(request)
+    });
+    return issue ?? new Response("Issue not found", { status: 404 });
+  }).post(`${issuePath}/:id/mute`, async ({ params, request }) => {
+    const issue = await muteVoiceMonitorIssue(issueStore, params.id, {
+      actorId: await actorFromRequest(request)
+    });
+    return issue ?? new Response("Issue not found", { status: 404 });
+  });
+  if (notifierPath !== false) {
+    routes.post(notifierPath, () => deliverVoiceMonitorIssueNotifications({
+      issueStore,
+      notifiers: options.notifiers ?? [],
+      receiptStore
+    }));
+  }
+  if (htmlPath !== false) {
+    routes.get(htmlPath, async () => {
+      const body = await (options.render ?? renderVoiceMonitorHTML)(await report(), { title: options.title });
+      return new Response(body, {
+        headers: {
+          "Content-Type": "text/html; charset=utf-8",
+          ...options.headers
+        }
+      });
+    });
+  }
+  return routes;
+};
 // src/readinessProfiles.ts
 var profileSurfaceLabels = {
   "meeting-recorder": {
@@ -28862,8 +29199,8 @@ var recommendVoiceReadinessProfile = (options) => {
   };
 };
 // src/providerStackRecommendations.ts
-import { Elysia as Elysia44 } from "elysia";
-var escapeHtml41 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+import { Elysia as Elysia45 } from "elysia";
+var escapeHtml42 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
 var profileProviderPriorities = {
   "meeting-recorder": {
     llm: ["openai", "anthropic", "gemini"],
@@ -29182,17 +29519,17 @@ var resolveProviderContractMatrixInput = async (matrix) => typeof matrix === "fu
 var renderVoiceProviderContractMatrixHTML = (report, options = {}) => {
   const title = options.title ?? "Voice Provider Contract Matrix";
   const rows = report.rows.map((row) => {
-    const checks = row.checks.map((check) => `<li class="${escapeHtml41(check.status)}"><strong>${escapeHtml41(check.label)}</strong><span>${escapeHtml41(check.detail ?? check.status)}</span>${check.remediation ? `<em>${check.remediation.href ? `<a href="${escapeHtml41(check.remediation.href)}">${escapeHtml41(check.remediation.label)}</a>` : escapeHtml41(check.remediation.label)}: ${escapeHtml41(check.remediation.detail)}</em>` : ""}</li>`).join("");
-    return `<article class="row ${escapeHtml41(row.status)}">
+    const checks = row.checks.map((check) => `<li class="${escapeHtml42(check.status)}"><strong>${escapeHtml42(check.label)}</strong><span>${escapeHtml42(check.detail ?? check.status)}</span>${check.remediation ? `<em>${check.remediation.href ? `<a href="${escapeHtml42(check.remediation.href)}">${escapeHtml42(check.remediation.label)}</a>` : escapeHtml42(check.remediation.label)}: ${escapeHtml42(check.remediation.detail)}</em>` : ""}</li>`).join("");
+    return `<article class="row ${escapeHtml42(row.status)}">
   <div>
-    <p class="eyebrow">${escapeHtml41(row.kind)}${row.selected ? " \xB7 selected" : ""}</p>
-    <h2>${escapeHtml41(row.provider)}</h2>
-    <p class="status ${escapeHtml41(row.status)}">${escapeHtml41(row.status.toUpperCase())}</p>
+    <p class="eyebrow">${escapeHtml42(row.kind)}${row.selected ? " \xB7 selected" : ""}</p>
+    <h2>${escapeHtml42(row.provider)}</h2>
+    <p class="status ${escapeHtml42(row.status)}">${escapeHtml42(row.status.toUpperCase())}</p>
   </div>
   <ul>${checks}</ul>
 </article>`;
   }).join("");
-  const snippet = escapeHtml41(`const providerContracts = () =>
+  const snippet = escapeHtml42(`const providerContracts = () =>
 	createVoiceProviderContractMatrixPreset('phone-agent', {
 		env: process.env,
 		providers: {
@@ -29213,7 +29550,7 @@ createVoiceProductionReadinessRoutes({
 	providerContractMatrix: () =>
 		buildVoiceProviderContractMatrix(providerContracts())
 });`);
-  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml41(title)}</title><style>body{background:#0f1412;color:#f7f3e8;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1180px;padding:32px}.hero,.primitive,.row{background:#17201b;border:1px solid #2d3b32;border-radius:24px;margin-bottom:16px;padding:22px}.hero{background:linear-gradient(135deg,rgba(34,197,94,.16),rgba(125,211,252,.12))}.primitive{background:#111814;border-color:#41604a}.eyebrow{color:#86efac;font-size:.78rem;font-weight:900;letter-spacing:.1em;text-transform:uppercase}h1{font-size:clamp(2.4rem,6vw,5rem);letter-spacing:-.06em;line-height:.9;margin:.2rem 0 1rem}h2{margin:.2rem 0}.summary{display:flex;flex-wrap:wrap;gap:10px}.pill,.status{border:1px solid #3f4f45;border-radius:999px;display:inline-flex;padding:8px 12px}.primitive code{color:#bbf7d0}.primitive p{color:#c8d8ca;line-height:1.55;margin:.45rem 0 0}.primitive pre{background:#08110d;border:1px solid #294132;border-radius:18px;color:#d9f99d;margin:16px 0 0;overflow:auto;padding:16px}.status.pass,.row.pass,.pass{border-color:rgba(34,197,94,.65)}.status.warn,.row.warn,.warn{border-color:rgba(245,158,11,.7)}.status.fail,.row.fail,.fail{border-color:rgba(239,68,68,.75)}.row{display:grid;gap:20px;grid-template-columns:minmax(180px,.45fr) 1fr}.row ul{display:grid;gap:10px;list-style:none;margin:0;padding:0}.row li{background:#111814;border:1px solid #2d3b32;border-radius:16px;display:grid;gap:4px;padding:12px}.row li span{color:#b8c2ba}.row li em{color:#f9d77e;font-style:normal}.row li a{color:#86efac}@media(max-width:760px){main{padding:18px}.row{grid-template-columns:1fr}}</style></head><body><main><section class="hero"><p class="eyebrow">Provider contracts</p><h1>${escapeHtml41(title)}</h1><p>Self-hosted provider proof for configured state, required env, latency budgets, fallback, streaming, and declared capabilities.</p><div class="summary"><span class="pill">${String(report.passed)} passing</span><span class="pill">${String(report.warned)} warning</span><span class="pill">${String(report.failed)} failing</span><span class="pill">${String(report.total)} total</span></div></section><section class="primitive"><p class="eyebrow">Copy into your app</p><h2><code>createVoiceProviderContractMatrixPreset(...)</code> builds this matrix</h2><p>Give AbsoluteJS your configured LLM, STT, and TTS providers once. It turns them into deploy-checkable proof for env, fallback, streaming, latency budgets, selected providers, and profile-required capabilities without a hosted dashboard.</p><pre><code>${snippet}</code></pre></section>${rows || '<article class="row"><p>No provider contracts configured.</p></article>'}</main></body></html>`;
+  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml42(title)}</title><style>body{background:#0f1412;color:#f7f3e8;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1180px;padding:32px}.hero,.primitive,.row{background:#17201b;border:1px solid #2d3b32;border-radius:24px;margin-bottom:16px;padding:22px}.hero{background:linear-gradient(135deg,rgba(34,197,94,.16),rgba(125,211,252,.12))}.primitive{background:#111814;border-color:#41604a}.eyebrow{color:#86efac;font-size:.78rem;font-weight:900;letter-spacing:.1em;text-transform:uppercase}h1{font-size:clamp(2.4rem,6vw,5rem);letter-spacing:-.06em;line-height:.9;margin:.2rem 0 1rem}h2{margin:.2rem 0}.summary{display:flex;flex-wrap:wrap;gap:10px}.pill,.status{border:1px solid #3f4f45;border-radius:999px;display:inline-flex;padding:8px 12px}.primitive code{color:#bbf7d0}.primitive p{color:#c8d8ca;line-height:1.55;margin:.45rem 0 0}.primitive pre{background:#08110d;border:1px solid #294132;border-radius:18px;color:#d9f99d;margin:16px 0 0;overflow:auto;padding:16px}.status.pass,.row.pass,.pass{border-color:rgba(34,197,94,.65)}.status.warn,.row.warn,.warn{border-color:rgba(245,158,11,.7)}.status.fail,.row.fail,.fail{border-color:rgba(239,68,68,.75)}.row{display:grid;gap:20px;grid-template-columns:minmax(180px,.45fr) 1fr}.row ul{display:grid;gap:10px;list-style:none;margin:0;padding:0}.row li{background:#111814;border:1px solid #2d3b32;border-radius:16px;display:grid;gap:4px;padding:12px}.row li span{color:#b8c2ba}.row li em{color:#f9d77e;font-style:normal}.row li a{color:#86efac}@media(max-width:760px){main{padding:18px}.row{grid-template-columns:1fr}}</style></head><body><main><section class="hero"><p class="eyebrow">Provider contracts</p><h1>${escapeHtml42(title)}</h1><p>Self-hosted provider proof for configured state, required env, latency budgets, fallback, streaming, and declared capabilities.</p><div class="summary"><span class="pill">${String(report.passed)} passing</span><span class="pill">${String(report.warned)} warning</span><span class="pill">${String(report.failed)} failing</span><span class="pill">${String(report.total)} total</span></div></section><section class="primitive"><p class="eyebrow">Copy into your app</p><h2><code>createVoiceProviderContractMatrixPreset(...)</code> builds this matrix</h2><p>Give AbsoluteJS your configured LLM, STT, and TTS providers once. It turns them into deploy-checkable proof for env, fallback, streaming, latency budgets, selected providers, and profile-required capabilities without a hosted dashboard.</p><pre><code>${snippet}</code></pre></section>${rows || '<article class="row"><p>No provider contracts configured.</p></article>'}</main></body></html>`;
 };
 var createVoiceProviderContractMatrixJSONHandler = (matrix) => async () => buildVoiceProviderContractMatrix(await resolveProviderContractMatrixInput(matrix));
 var createVoiceProviderContractMatrixHTMLHandler = (options) => async () => {
@@ -29228,7 +29565,7 @@ var createVoiceProviderContractMatrixHTMLHandler = (options) => async () => {
 var createVoiceProviderContractMatrixRoutes = (options) => {
   const path = options.path ?? "/api/provider-contracts";
   const htmlPath = options.htmlPath ?? "/provider-contracts";
-  const routes = new Elysia44({
+  const routes = new Elysia45({
     name: options.name ?? "absolutejs-voice-provider-contract-matrix"
   });
   const jsonHandler = createVoiceProviderContractMatrixJSONHandler(options.matrix);
@@ -29346,7 +29683,7 @@ var assertVoiceProviderStackEvidence = (report, input = {}) => {
   return assertion;
 };
 // src/opsConsoleRoutes.ts
-import { Elysia as Elysia45 } from "elysia";
+import { Elysia as Elysia46 } from "elysia";
 var DEFAULT_LINKS = [
   {
     description: "Quality gates for CI, deploy checks, and production readiness.",
@@ -29381,7 +29718,7 @@ var DEFAULT_LINKS = [
     label: "Handoffs"
   }
 ];
-var escapeHtml42 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+var escapeHtml43 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
 var countProviderStatuses = (providers) => {
   const degradedStatuses = new Set(["degraded", "rate-limited", "suppressed"]);
   const healthy = providers.filter((provider) => provider.status === "healthy").length;
@@ -29450,20 +29787,20 @@ var buildVoiceOpsConsoleReport = async (options) => {
     trace
   };
 };
-var renderMetricCard = (input) => `<article class="metric"><span>${escapeHtml42(input.label)}</span><strong>${escapeHtml42(String(input.value))}</strong>${input.status ? `<p class="${escapeHtml42(input.status)}">${escapeHtml42(input.status)}</p>` : ""}${input.href ? `<a href="${escapeHtml42(input.href)}">Open</a>` : ""}</article>`;
+var renderMetricCard = (input) => `<article class="metric"><span>${escapeHtml43(input.label)}</span><strong>${escapeHtml43(String(input.value))}</strong>${input.status ? `<p class="${escapeHtml43(input.status)}">${escapeHtml43(input.status)}</p>` : ""}${input.href ? `<a href="${escapeHtml43(input.href)}">Open</a>` : ""}</article>`;
 var renderVoiceOpsConsoleHTML = (report, options = {}) => {
   const links = report.links.map((link) => `<article class="surface">
-<div><h2>${escapeHtml42(link.label)}</h2>${link.description ? `<p>${escapeHtml42(link.description)}</p>` : ""}</div>
-<p><a href="${escapeHtml42(link.href)}">Open ${escapeHtml42(link.label)}</a>${link.statusHref ? ` \xB7 <a href="${escapeHtml42(link.statusHref)}">Status</a>` : ""}</p>
+<div><h2>${escapeHtml43(link.label)}</h2>${link.description ? `<p>${escapeHtml43(link.description)}</p>` : ""}</div>
+<p><a href="${escapeHtml43(link.href)}">Open ${escapeHtml43(link.label)}</a>${link.statusHref ? ` \xB7 <a href="${escapeHtml43(link.statusHref)}">Status</a>` : ""}</p>
 </article>`).join("");
-  const sessions = report.recentSessions.length ? report.recentSessions.map((session) => `<tr><td>${escapeHtml42(session.sessionId)}</td><td>${escapeHtml42(session.status)}</td><td>${session.turnCount}</td><td>${session.errorCount}</td><td>${session.replayHref ? `<a href="${escapeHtml42(session.replayHref)}">Replay</a>` : ""}</td></tr>`).join("") : '<tr><td colspan="5">No sessions yet.</td></tr>';
-  const routing = report.recentRoutingEvents.length ? report.recentRoutingEvents.map((event) => `<tr><td>${escapeHtml42(event.kind)}</td><td>${escapeHtml42(event.provider ?? "unknown")}</td><td>${escapeHtml42(event.status ?? "unknown")}</td><td>${event.elapsedMs ?? 0}ms</td><td>${escapeHtml42(event.sessionId)}</td></tr>`).join("") : '<tr><td colspan="5">No provider routing events yet.</td></tr>';
+  const sessions = report.recentSessions.length ? report.recentSessions.map((session) => `<tr><td>${escapeHtml43(session.sessionId)}</td><td>${escapeHtml43(session.status)}</td><td>${session.turnCount}</td><td>${session.errorCount}</td><td>${session.replayHref ? `<a href="${escapeHtml43(session.replayHref)}">Replay</a>` : ""}</td></tr>`).join("") : '<tr><td colspan="5">No sessions yet.</td></tr>';
+  const routing = report.recentRoutingEvents.length ? report.recentRoutingEvents.map((event) => `<tr><td>${escapeHtml43(event.kind)}</td><td>${escapeHtml43(event.provider ?? "unknown")}</td><td>${escapeHtml43(event.status ?? "unknown")}</td><td>${event.elapsedMs ?? 0}ms</td><td>${escapeHtml43(event.sessionId)}</td></tr>`).join("") : '<tr><td colspan="5">No provider routing events yet.</td></tr>';
   const title = options.title ?? "AbsoluteJS Voice Ops Console";
-  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml42(title)}</title><style>body{font-family:ui-sans-serif,system-ui,sans-serif;background:#101316;color:#f6f2e8;margin:0}main{max-width:1180px;margin:auto;padding:32px}a{color:#fbbf24}header{display:flex;justify-content:space-between;gap:24px;align-items:flex-start;margin-bottom:24px}.eyebrow{color:#fbbf24;font-weight:800;letter-spacing:.08em;text-transform:uppercase}h1{font-size:clamp(2.2rem,5vw,4.5rem);line-height:.95;margin:.2rem 0 1rem}.muted{color:#a8b0b8}.grid{display:grid;gap:14px;grid-template-columns:repeat(auto-fit,minmax(180px,1fr));margin:20px 0}.metric,.surface{background:#181d22;border:1px solid #2a323a;border-radius:20px;padding:18px}.metric strong{display:block;font-size:2.2rem;margin:.25rem 0}.pass,.healthy{color:#86efac}.fail,.failed,.degraded{color:#fca5a5}.surfaces{display:grid;gap:16px;grid-template-columns:repeat(auto-fit,minmax(240px,1fr));margin:24px 0}table{width:100%;border-collapse:collapse;background:#181d22;border-radius:16px;overflow:hidden;margin:12px 0 28px}td,th{border-bottom:1px solid #2a323a;padding:12px;text-align:left}section{margin-top:30px}@media(max-width:700px){main{padding:20px}header{display:block}}</style></head><body><main><header><div><p class="eyebrow">Self-hosted voice operations</p><h1>${escapeHtml42(title)}</h1><p class="muted">One deployable control plane for quality gates, failover, traces, sessions, handoffs, and provider health.</p></div><p class="muted">Checked ${escapeHtml42(new Date(report.checkedAt).toLocaleString())}</p></header><div class="grid">${renderMetricCard({ label: "Quality", value: report.quality.status, status: report.quality.status, href: "/quality" })}${renderMetricCard({ label: "Events", value: report.eventCount, href: "/diagnostics" })}${renderMetricCard({ label: "Sessions", value: report.sessions.total, status: report.sessions.failed > 0 ? "failed" : "healthy", href: "/sessions" })}${renderMetricCard({ label: "Handoffs failed", value: report.handoffs.failed, status: report.handoffs.failed > 0 ? "failed" : "healthy", href: "/handoffs" })}${renderMetricCard({ label: "Providers degraded", value: report.providers.degraded, status: report.providers.degraded > 0 ? "degraded" : "healthy", href: "/resilience" })}</div><section><h2>Operational Surfaces</h2><div class="surfaces">${links}</div></section><section><h2>Recent Sessions</h2><table><thead><tr><th>Session</th><th>Status</th><th>Turns</th><th>Errors</th><th>Replay</th></tr></thead><tbody>${sessions}</tbody></table></section><section><h2>Recent Provider Routing</h2><table><thead><tr><th>Kind</th><th>Provider</th><th>Status</th><th>Elapsed</th><th>Session</th></tr></thead><tbody>${routing}</tbody></table></section></main></body></html>`;
+  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml43(title)}</title><style>body{font-family:ui-sans-serif,system-ui,sans-serif;background:#101316;color:#f6f2e8;margin:0}main{max-width:1180px;margin:auto;padding:32px}a{color:#fbbf24}header{display:flex;justify-content:space-between;gap:24px;align-items:flex-start;margin-bottom:24px}.eyebrow{color:#fbbf24;font-weight:800;letter-spacing:.08em;text-transform:uppercase}h1{font-size:clamp(2.2rem,5vw,4.5rem);line-height:.95;margin:.2rem 0 1rem}.muted{color:#a8b0b8}.grid{display:grid;gap:14px;grid-template-columns:repeat(auto-fit,minmax(180px,1fr));margin:20px 0}.metric,.surface{background:#181d22;border:1px solid #2a323a;border-radius:20px;padding:18px}.metric strong{display:block;font-size:2.2rem;margin:.25rem 0}.pass,.healthy{color:#86efac}.fail,.failed,.degraded{color:#fca5a5}.surfaces{display:grid;gap:16px;grid-template-columns:repeat(auto-fit,minmax(240px,1fr));margin:24px 0}table{width:100%;border-collapse:collapse;background:#181d22;border-radius:16px;overflow:hidden;margin:12px 0 28px}td,th{border-bottom:1px solid #2a323a;padding:12px;text-align:left}section{margin-top:30px}@media(max-width:700px){main{padding:20px}header{display:block}}</style></head><body><main><header><div><p class="eyebrow">Self-hosted voice operations</p><h1>${escapeHtml43(title)}</h1><p class="muted">One deployable control plane for quality gates, failover, traces, sessions, handoffs, and provider health.</p></div><p class="muted">Checked ${escapeHtml43(new Date(report.checkedAt).toLocaleString())}</p></header><div class="grid">${renderMetricCard({ label: "Quality", value: report.quality.status, status: report.quality.status, href: "/quality" })}${renderMetricCard({ label: "Events", value: report.eventCount, href: "/diagnostics" })}${renderMetricCard({ label: "Sessions", value: report.sessions.total, status: report.sessions.failed > 0 ? "failed" : "healthy", href: "/sessions" })}${renderMetricCard({ label: "Handoffs failed", value: report.handoffs.failed, status: report.handoffs.failed > 0 ? "failed" : "healthy", href: "/handoffs" })}${renderMetricCard({ label: "Providers degraded", value: report.providers.degraded, status: report.providers.degraded > 0 ? "degraded" : "healthy", href: "/resilience" })}</div><section><h2>Operational Surfaces</h2><div class="surfaces">${links}</div></section><section><h2>Recent Sessions</h2><table><thead><tr><th>Session</th><th>Status</th><th>Turns</th><th>Errors</th><th>Replay</th></tr></thead><tbody>${sessions}</tbody></table></section><section><h2>Recent Provider Routing</h2><table><thead><tr><th>Kind</th><th>Provider</th><th>Status</th><th>Elapsed</th><th>Session</th></tr></thead><tbody>${routing}</tbody></table></section></main></body></html>`;
 };
 var createVoiceOpsConsoleRoutes = (options) => {
   const path = options.path ?? "/ops-console";
-  const routes = new Elysia45({
+  const routes = new Elysia46({
     name: options.name ?? "absolutejs-voice-ops-console"
   });
   const getReport = () => buildVoiceOpsConsoleReport(options);
@@ -29480,7 +29817,7 @@ var createVoiceOpsConsoleRoutes = (options) => {
   return routes;
 };
 // src/incidentBundle.ts
-import { Elysia as Elysia46 } from "elysia";
+import { Elysia as Elysia47 } from "elysia";
 var filterIncidentBundleArtifacts = (artifacts, filter = {}) => artifacts.filter((artifact) => {
   if (filter.sessionId && artifact.sessionId !== filter.sessionId) {
     return false;
@@ -29681,7 +30018,7 @@ var buildVoiceIncidentBundle = async (options) => {
 var createVoiceIncidentBundleRoutes = (options) => {
   const path = options.path ?? "/api/voice-incidents/:sessionId";
   const markdownPath = options.markdownPath === undefined ? "/voice-incidents/:sessionId/markdown" : options.markdownPath;
-  const routes = new Elysia46({
+  const routes = new Elysia47({
     name: options.name ?? "absolutejs-voice-incident-bundle"
   });
   const getSessionId = (params) => params.sessionId ?? "";
@@ -29882,19 +30219,19 @@ var summarizeVoiceOpsStatus = async (options) => {
   };
 };
 // src/opsStatusRoutes.ts
-import { Elysia as Elysia47 } from "elysia";
-var escapeHtml43 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+import { Elysia as Elysia48 } from "elysia";
+var escapeHtml44 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
 var renderVoiceOpsStatusHTML = (report, options = {}) => {
   const title = options.title ?? "AbsoluteJS Voice Ops Status";
   const surfaces = Object.entries(report.surfaces).map(([key, surface]) => {
     const value = "recovered" in surface ? surface.total === 0 ? "0 events" : `${surface.recovered}/${surface.total}` : ("auditTotal" in surface) ? `${surface.auditTotal + surface.traceTotal} deliveries` : ("total" in surface) ? `${Math.max(surface.total - ("failed" in surface ? surface.failed : ("degraded" in surface) ? surface.degraded : 0), 0)}/${surface.total}` : surface.status;
-    return `<article class="surface ${escapeHtml43(surface.status)}"><span>${escapeHtml43(surface.status.toUpperCase())}</span><h2>${escapeHtml43(key)}</h2><strong>${escapeHtml43(value)}</strong></article>`;
+    return `<article class="surface ${escapeHtml44(surface.status)}"><span>${escapeHtml44(surface.status.toUpperCase())}</span><h2>${escapeHtml44(key)}</h2><strong>${escapeHtml44(value)}</strong></article>`;
   }).join("");
-  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml43(title)}</title><style>body{background:#0d141b;color:#f8f3e7;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:980px;padding:32px}.hero{background:linear-gradient(135deg,rgba(20,184,166,.2),rgba(245,158,11,.12));border:1px solid #283544;border-radius:28px;margin-bottom:18px;padding:28px}.eyebrow{color:#5eead4;font-weight:900;letter-spacing:.12em;text-transform:uppercase}h1{font-size:clamp(2.4rem,6vw,5rem);line-height:.9;margin:.2rem 0 1rem}.status{border:1px solid #3f3f46;border-radius:999px;display:inline-flex;font-weight:900;padding:8px 12px}.surfaces{display:grid;gap:14px;grid-template-columns:repeat(auto-fit,minmax(180px,1fr))}.surface{background:#151d26;border:1px solid #283544;border-radius:20px;padding:18px}.surface span{color:#aab5c0;font-size:.78rem;font-weight:900;letter-spacing:.08em}.surface strong{font-size:1.5rem}.pass{border-color:rgba(34,197,94,.55)}.fail{border-color:rgba(239,68,68,.75)}a{color:#5eead4}</style></head><body><main><section class="hero"><p class="eyebrow">Ops status</p><h1>${escapeHtml43(title)}</h1><p>Compact pass/fail status for framework widgets, demos, and small customer-facing health badges.</p><p class="status ${escapeHtml43(report.status)}">Overall: ${escapeHtml43(report.status.toUpperCase())}</p><p>${report.passed}/${report.total} checks passing</p></section><section class="surfaces">${surfaces || '<article class="surface pass"><span>PASS</span><h2>No checks configured</h2><strong>0/0</strong></article>'}</section></main></body></html>`;
+  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml44(title)}</title><style>body{background:#0d141b;color:#f8f3e7;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:980px;padding:32px}.hero{background:linear-gradient(135deg,rgba(20,184,166,.2),rgba(245,158,11,.12));border:1px solid #283544;border-radius:28px;margin-bottom:18px;padding:28px}.eyebrow{color:#5eead4;font-weight:900;letter-spacing:.12em;text-transform:uppercase}h1{font-size:clamp(2.4rem,6vw,5rem);line-height:.9;margin:.2rem 0 1rem}.status{border:1px solid #3f3f46;border-radius:999px;display:inline-flex;font-weight:900;padding:8px 12px}.surfaces{display:grid;gap:14px;grid-template-columns:repeat(auto-fit,minmax(180px,1fr))}.surface{background:#151d26;border:1px solid #283544;border-radius:20px;padding:18px}.surface span{color:#aab5c0;font-size:.78rem;font-weight:900;letter-spacing:.08em}.surface strong{font-size:1.5rem}.pass{border-color:rgba(34,197,94,.55)}.fail{border-color:rgba(239,68,68,.75)}a{color:#5eead4}</style></head><body><main><section class="hero"><p class="eyebrow">Ops status</p><h1>${escapeHtml44(title)}</h1><p>Compact pass/fail status for framework widgets, demos, and small customer-facing health badges.</p><p class="status ${escapeHtml44(report.status)}">Overall: ${escapeHtml44(report.status.toUpperCase())}</p><p>${report.passed}/${report.total} checks passing</p></section><section class="surfaces">${surfaces || '<article class="surface pass"><span>PASS</span><h2>No checks configured</h2><strong>0/0</strong></article>'}</section></main></body></html>`;
 };
 var createVoiceOpsStatusRoutes = (options) => {
   const path = options.path ?? "/api/voice/ops-status";
-  const routes = new Elysia47({
+  const routes = new Elysia48({
     name: options.name ?? "absolutejs-voice-ops-status"
   });
   routes.get(path, async () => summarizeVoiceOpsStatus(options));
@@ -30327,8 +30664,8 @@ var createVoiceTTSProviderRouter = (options) => {
   };
 };
 // src/traceDeliveryRoutes.ts
-import { Elysia as Elysia48 } from "elysia";
-var escapeHtml44 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+import { Elysia as Elysia49 } from "elysia";
+var escapeHtml45 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
 var getString19 = (value) => typeof value === "string" && value.trim() ? value.trim() : undefined;
 var getNumber11 = (value) => {
   if (typeof value === "number" && Number.isFinite(value)) {
@@ -30409,14 +30746,14 @@ var renderSinkResults2 = (delivery) => {
   if (entries.length === 0) {
     return "<p>No sink delivery attempts recorded yet.</p>";
   }
-  return `<ul>${entries.map(([sinkId, result]) => `<li><strong>${escapeHtml44(sinkId)}</strong>: ${escapeHtml44(result.status)}${result.deliveredTo ? ` to ${escapeHtml44(result.deliveredTo)}` : ""}${result.error ? ` (${escapeHtml44(result.error)})` : ""}</li>`).join("")}</ul>`;
+  return `<ul>${entries.map(([sinkId, result]) => `<li><strong>${escapeHtml45(sinkId)}</strong>: ${escapeHtml45(result.status)}${result.deliveredTo ? ` to ${escapeHtml45(result.deliveredTo)}` : ""}${result.error ? ` (${escapeHtml45(result.error)})` : ""}</li>`).join("")}</ul>`;
 };
-var renderEventList2 = (delivery) => delivery.events.length === 0 ? "<p>No trace events in this delivery.</p>" : `<ul>${delivery.events.map((event) => `<li>${escapeHtml44(event.type)} <small>${escapeHtml44(event.id)}</small>${event.sessionId ? ` session=${escapeHtml44(event.sessionId)}` : ""}</li>`).join("")}</ul>`;
+var renderEventList2 = (delivery) => delivery.events.length === 0 ? "<p>No trace events in this delivery.</p>" : `<ul>${delivery.events.map((event) => `<li>${escapeHtml45(event.type)} <small>${escapeHtml45(event.id)}</small>${event.sessionId ? ` session=${escapeHtml45(event.sessionId)}` : ""}</li>`).join("")}</ul>`;
 var renderVoiceTraceDeliveryHTML = (report, options = {}) => {
   const title = options.title ?? "AbsoluteJS Voice Trace Deliveries";
-  const drainAction = options.workerPath === false ? "" : `<form method="post" action="${escapeHtml44(options.workerPath ?? "/api/voice-trace-deliveries/drain")}"><button type="submit">Drain trace deliveries</button></form>`;
-  const rows = report.deliveries.map((delivery) => `<article class="delivery ${escapeHtml44(delivery.deliveryStatus)}"><div class="head"><div><span>${escapeHtml44(delivery.deliveryStatus)}</span><h2>${escapeHtml44(delivery.id)}</h2><p>${escapeHtml44(new Date(delivery.createdAt).toLocaleString())}${delivery.deliveredAt ? ` \xB7 delivered ${escapeHtml44(new Date(delivery.deliveredAt).toLocaleString())}` : ""}</p></div><strong>${String(delivery.deliveryAttempts ?? 0)} attempt(s)</strong></div>${delivery.deliveryError ? `<p class="error">${escapeHtml44(delivery.deliveryError)}</p>` : ""}<h3>Sinks</h3>${renderSinkResults2(delivery)}<h3>Events</h3>${renderEventList2(delivery)}</article>`).join("");
-  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml44(title)}</title><style>body{background:#0f1318;color:#f4efe1;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1120px;padding:32px}.hero{background:linear-gradient(135deg,rgba(34,197,94,.16),rgba(14,165,233,.14));border:1px solid #26313d;border-radius:28px;margin-bottom:18px;padding:28px}.eyebrow{color:#86efac;font-weight:900;letter-spacing:.12em;text-transform:uppercase}h1{font-size:clamp(2.2rem,5vw,4.8rem);line-height:.92;margin:.2rem 0 1rem}.grid{display:grid;gap:12px;grid-template-columns:repeat(4,1fr);margin-bottom:16px}.grid article,.delivery{background:#151b22;border:1px solid #26313d;border-radius:22px;padding:18px}.grid span,.delivery span{color:#86efac;font-size:.78rem;font-weight:900;letter-spacing:.08em;text-transform:uppercase}.grid strong{display:block;font-size:2rem}.deliveries{display:grid;gap:14px}.delivery.failed{border-color:rgba(239,68,68,.75)}.delivery.pending{border-color:rgba(245,158,11,.7)}.delivery.delivered{border-color:rgba(34,197,94,.55)}.delivery.skipped{border-color:rgba(148,163,184,.6)}.head{align-items:start;display:flex;gap:14px;justify-content:space-between}.delivery h2{font-size:1.05rem;margin:.3rem 0;overflow-wrap:anywhere}.delivery h3{margin:1rem 0 .3rem}.delivery p,.delivery li{color:#c8d0d8}.error{color:#fecaca!important}button{background:#86efac;border:0;border-radius:999px;color:#07111f;cursor:pointer;font-weight:900;margin-top:12px;padding:10px 14px}@media(max-width:760px){main{padding:20px}.grid{grid-template-columns:1fr 1fr}.head{display:block}}</style></head><body><main><section class="hero"><p class="eyebrow">Trace export health</p><h1>${escapeHtml44(title)}</h1><p>Checked ${escapeHtml44(new Date(report.checkedAt).toLocaleString())}. Showing ${String(report.deliveries.length)} delivery item(s).</p>${drainAction}</section>${renderMetricGrid3(report)}<section class="deliveries">${rows || "<p>No trace deliveries match this filter.</p>"}</section></main></body></html>`;
+  const drainAction = options.workerPath === false ? "" : `<form method="post" action="${escapeHtml45(options.workerPath ?? "/api/voice-trace-deliveries/drain")}"><button type="submit">Drain trace deliveries</button></form>`;
+  const rows = report.deliveries.map((delivery) => `<article class="delivery ${escapeHtml45(delivery.deliveryStatus)}"><div class="head"><div><span>${escapeHtml45(delivery.deliveryStatus)}</span><h2>${escapeHtml45(delivery.id)}</h2><p>${escapeHtml45(new Date(delivery.createdAt).toLocaleString())}${delivery.deliveredAt ? ` \xB7 delivered ${escapeHtml45(new Date(delivery.deliveredAt).toLocaleString())}` : ""}</p></div><strong>${String(delivery.deliveryAttempts ?? 0)} attempt(s)</strong></div>${delivery.deliveryError ? `<p class="error">${escapeHtml45(delivery.deliveryError)}</p>` : ""}<h3>Sinks</h3>${renderSinkResults2(delivery)}<h3>Events</h3>${renderEventList2(delivery)}</article>`).join("");
+  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml45(title)}</title><style>body{background:#0f1318;color:#f4efe1;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1120px;padding:32px}.hero{background:linear-gradient(135deg,rgba(34,197,94,.16),rgba(14,165,233,.14));border:1px solid #26313d;border-radius:28px;margin-bottom:18px;padding:28px}.eyebrow{color:#86efac;font-weight:900;letter-spacing:.12em;text-transform:uppercase}h1{font-size:clamp(2.2rem,5vw,4.8rem);line-height:.92;margin:.2rem 0 1rem}.grid{display:grid;gap:12px;grid-template-columns:repeat(4,1fr);margin-bottom:16px}.grid article,.delivery{background:#151b22;border:1px solid #26313d;border-radius:22px;padding:18px}.grid span,.delivery span{color:#86efac;font-size:.78rem;font-weight:900;letter-spacing:.08em;text-transform:uppercase}.grid strong{display:block;font-size:2rem}.deliveries{display:grid;gap:14px}.delivery.failed{border-color:rgba(239,68,68,.75)}.delivery.pending{border-color:rgba(245,158,11,.7)}.delivery.delivered{border-color:rgba(34,197,94,.55)}.delivery.skipped{border-color:rgba(148,163,184,.6)}.head{align-items:start;display:flex;gap:14px;justify-content:space-between}.delivery h2{font-size:1.05rem;margin:.3rem 0;overflow-wrap:anywhere}.delivery h3{margin:1rem 0 .3rem}.delivery p,.delivery li{color:#c8d0d8}.error{color:#fecaca!important}button{background:#86efac;border:0;border-radius:999px;color:#07111f;cursor:pointer;font-weight:900;margin-top:12px;padding:10px 14px}@media(max-width:760px){main{padding:20px}.grid{grid-template-columns:1fr 1fr}.head{display:block}}</style></head><body><main><section class="hero"><p class="eyebrow">Trace export health</p><h1>${escapeHtml45(title)}</h1><p>Checked ${escapeHtml45(new Date(report.checkedAt).toLocaleString())}. Showing ${String(report.deliveries.length)} delivery item(s).</p>${drainAction}</section>${renderMetricGrid3(report)}<section class="deliveries">${rows || "<p>No trace deliveries match this filter.</p>"}</section></main></body></html>`;
 };
 var createVoiceTraceDeliveryJSONHandler = (options) => async ({ query }) => buildVoiceTraceDeliveryReport(options, resolveVoiceTraceDeliveryFilter(query, options.filter));
 var createVoiceTraceDeliveryHTMLHandler = (options) => async ({ query }) => {
@@ -30436,7 +30773,7 @@ var createVoiceTraceDeliveryRoutes = (options) => {
   const path = options.path ?? "/api/voice-trace-deliveries";
   const htmlPath = options.htmlPath === undefined ? "/traces/deliveries" : options.htmlPath;
   const workerPath = options.workerPath === undefined ? `${path}/drain` : options.workerPath;
-  const routes = new Elysia48({
+  const routes = new Elysia49({
     name: options.name ?? "absolutejs-voice-trace-deliveries"
   }).get(path, createVoiceTraceDeliveryJSONHandler(options));
   if (htmlPath !== false) {
@@ -30533,7 +30870,7 @@ var createVoiceMemoryStore = () => {
   return { get, getOrCreate, list, remove, set };
 };
 // src/opsWebhook.ts
-import { Elysia as Elysia49 } from "elysia";
+import { Elysia as Elysia50 } from "elysia";
 var toHex6 = (bytes) => Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join("");
 var signVoiceOpsWebhookBody = async (input) => {
   const encoder = new TextEncoder;
@@ -30663,7 +31000,7 @@ var verifyVoiceOpsWebhookSignature = async (input) => {
 };
 var createVoiceOpsWebhookReceiverRoutes = (options = {}) => {
   const path = options.path ?? "/api/voice-ops/webhook";
-  return new Elysia49().post(path, async ({ body, request, set }) => {
+  return new Elysia50().post(path, async ({ body, request, set }) => {
     const bodyText = typeof body === "string" ? body : JSON.stringify(body);
     if (options.signingSecret) {
       const verification = await verifyVoiceOpsWebhookSignature({
@@ -31118,7 +31455,7 @@ var resolveVoiceOpsPreset = (name, overrides = {}) => {
   };
 };
 // src/postCallAnalysis.ts
-import { Elysia as Elysia50 } from "elysia";
+import { Elysia as Elysia51 } from "elysia";
 var isStore = (value) => Boolean(value) && typeof value === "object" && value !== null && ("list" in value);
 var asArray = async (value) => Array.isArray(value) ? value : isStore(value) ? await value.list() : [];
 var getPathValue3 = (source, path) => {
@@ -31297,7 +31634,7 @@ var resolvePostCallAnalysisReport = async (options, input) => {
 };
 var createVoicePostCallAnalysisRoutes = (options = {}) => {
   const path = options.path ?? "/api/voice/post-call-analysis";
-  const routes = new Elysia50({
+  const routes = new Elysia51({
     name: options.name ?? "absolutejs-voice-post-call-analysis"
   });
   routes.get(path, async ({ query }) => {
@@ -31322,7 +31659,7 @@ var createVoicePostCallAnalysisRoutes = (options = {}) => {
   return routes;
 };
 // src/guardrails.ts
-import { Elysia as Elysia51 } from "elysia";
+import { Elysia as Elysia52 } from "elysia";
 var stringifyContent = (value) => typeof value === "string" ? value : JSON.stringify(value) ?? "";
 var appliesToStage = (rule, stage) => !rule.stages || rule.stages.length === 0 || rule.stages.includes(stage);
 var matchesRule = async (rule, input) => {
@@ -31624,7 +31961,7 @@ var resolveGuardrailReport = async (options, input) => {
 };
 var createVoiceGuardrailRoutes = (options = {}) => {
   const path = options.path ?? "/api/voice/guardrails";
-  const routes = new Elysia51({
+  const routes = new Elysia52({
     name: options.name ?? "absolutejs-voice-guardrails"
   });
   routes.all(path, async ({ request }) => {
@@ -32120,6 +32457,7 @@ export {
   resolveVoiceOpsTaskAssignment,
   resolveVoiceOpsTaskAgeBucket,
   resolveVoiceOpsPreset,
+  resolveVoiceMonitorIssue,
   resolveVoiceDiagnosticsTraceFilter,
   resolveVoiceAuditTrailFilter,
   resolveVoiceAuditDeliveryFilter,
@@ -32164,6 +32502,8 @@ export {
   renderVoiceOperationsRecordGuardrailMarkdown,
   renderVoiceObservabilityExportReplayHTML,
   renderVoiceObservabilityExportMarkdown,
+  renderVoiceMonitorMarkdown,
+  renderVoiceMonitorHTML,
   renderVoiceLiveLatencyHTML,
   renderVoiceLatencySLOMarkdown,
   renderVoiceHandoffHealthHTML,
@@ -32206,6 +32546,7 @@ export {
   pruneVoiceIncidentBundleArtifacts,
   parseVoiceTelephonyWebhookEvent,
   normalizeVoiceProofTrendReport,
+  muteVoiceMonitorIssue,
   matchesVoiceOpsTaskAssignmentRule,
   markVoiceOpsTaskSLABreached,
   loadVoiceObservabilityExportReplaySource,
@@ -32254,6 +32595,7 @@ export {
   encodeTwilioMulawBase64,
   deliverVoiceTraceEventsToSinks,
   deliverVoiceObservabilityExport,
+  deliverVoiceMonitorIssueNotifications,
   deliverVoiceIntegrationEventToSinks,
   deliverVoiceIntegrationEvent,
   deliverVoiceHandoffDelivery,
@@ -32408,10 +32750,14 @@ export {
   createVoiceObservabilityExportSchema,
   createVoiceObservabilityExportRoutes,
   createVoiceObservabilityExportReplayRoutes,
+  createVoiceMonitorWebhookNotifier,
+  createVoiceMonitorRoutes,
   createVoiceMemoryTraceSinkDeliveryStore,
   createVoiceMemoryTraceEventStore,
   createVoiceMemoryStore,
   createVoiceMemoryObservabilityExportDeliveryReceiptStore,
+  createVoiceMemoryMonitorNotifierDeliveryReceiptStore,
+  createVoiceMemoryMonitorIssueStore,
   createVoiceMemoryLiveOpsControlStore,
   createVoiceMemoryIncidentBundleStore,
   createVoiceMemoryHandoffDeliveryStore,
@@ -32559,6 +32905,7 @@ export {
   buildVoiceObservabilityExportDeliveryHistory,
   buildVoiceObservabilityExport,
   buildVoiceObservabilityArtifactIndex,
+  buildVoiceMonitorRunReport,
   buildVoiceLiveOpsControlState,
   buildVoiceLatencySLOGate,
   buildVoiceIncidentBundle,
@@ -32611,6 +32958,7 @@ export {
   applyVoiceCampaignTelephonyOutcome,
   applyRiskTieredPhraseHintCorrections,
   applyPhraseHintCorrections,
+  acknowledgeVoiceMonitorIssue,
   VOICE_LIVE_OPS_ACTIONS,
   TURN_PROFILE_DEFAULTS,
   DEFAULT_VOICE_PROOF_TRENDS_MAX_AGE_MS

package/dist/productionReadiness.d.ts

@@ -2,6 +2,7 @@ import { Elysia } from 'elysia';
 import { type VoiceProviderFallbackRecoverySummary } from './sessionReplay';
 import { type VoiceTelephonyCarrierMatrixInput } from './telephony/matrix';
 import { type VoiceTelephonyWebhookSecurityOptions, type VoiceTelephonyWebhookSecurityReport } from './telephony/security';
+import type { VoiceMonitorNotifierDeliveryReport, VoiceMonitorRunReport } from './voiceMonitoring';
 import type { VoiceTraceEventStore } from './trace';
 import type { VoiceTraceSinkDeliveryStore } from './trace';
 import type { VoiceAgentSquadContractReport } from './agentSquadContract';
@@ -118,6 +119,8 @@ export type VoiceProductionReadinessReport = {
         operationsRecords?: string;
         observabilityExport?: string;
         observabilityExportDeliveries?: string;
+        monitoring?: string;
+        monitoringNotifierDelivery?: string;
         opsActions?: string;
         opsRecovery?: string;
         phoneAgentSmoke?: string;
@@ -176,6 +179,19 @@ export type VoiceProductionReadinessReport = {
             total: number;
             warnings: number;
         };
+        monitoring?: {
+            criticalOpen: number;
+            open: number;
+            status: VoiceProductionReadinessStatus;
+            total: number;
+        };
+        monitoringNotifierDelivery?: {
+            failed: number;
+            notifiers: number;
+            sent: number;
+            status: VoiceProductionReadinessStatus;
+            total: number;
+        };
         opsActionHistory?: VoiceProductionReadinessOpsActionHistorySummary;
         opsRecovery?: {
             issues: number;
@@ -393,6 +409,14 @@ export type VoiceProductionReadinessRoutesOptions = {
     links?: VoiceProductionReadinessReport['links'];
     llmProviders?: readonly string[];
     name?: string;
+    monitoring?: false | VoiceMonitorRunReport | ((input: {
+        query: Record<string, unknown>;
+        request: Request;
+    }) => Promise<VoiceMonitorRunReport> | VoiceMonitorRunReport);
+    monitoringNotifierDelivery?: false | VoiceMonitorNotifierDeliveryReport | ((input: {
+        query: Record<string, unknown>;
+        request: Request;
+    }) => Promise<VoiceMonitorNotifierDeliveryReport> | VoiceMonitorNotifierDeliveryReport);
     opsActionHistory?: false | VoiceProductionReadinessOpsActionHistoryOptions;
     opsRecovery?: false | VoiceOpsRecoveryReport | ((input: {
         query: Record<string, unknown>;

package/dist/voiceMonitoring.d.ts

@@ -0,0 +1,325 @@
+import { Elysia } from 'elysia';
+export type VoiceMonitorStatus = 'fail' | 'pass' | 'warn';
+export type VoiceMonitorSeverity = 'critical' | 'info' | 'warn';
+export type VoiceMonitorIssueStatus = 'acknowledged' | 'muted' | 'open' | 'resolved';
+export type VoiceMonitorEvaluationInput<TEvidence = unknown> = {
+    evidence: TEvidence;
+    now: number;
+};
+export type VoiceMonitorEvaluation = {
+    detail?: string;
+    impactedSessions?: readonly string[];
+    operationsRecordHrefs?: readonly string[];
+    status: VoiceMonitorStatus;
+    threshold?: number | string;
+    value?: number | string;
+};
+export type VoiceMonitorDefinition<TEvidence = unknown> = {
+    description?: string;
+    id: string;
+    label: string;
+    severity?: VoiceMonitorSeverity;
+    windowMs?: number;
+    evaluate: (input: VoiceMonitorEvaluationInput<TEvidence>) => Promise<VoiceMonitorEvaluation> | VoiceMonitorEvaluation;
+};
+export type VoiceMonitorRun = VoiceMonitorEvaluation & {
+    checkedAt: number;
+    description?: string;
+    id: string;
+    label: string;
+    severity: VoiceMonitorSeverity;
+    windowMs?: number;
+};
+export type VoiceMonitorIssue = {
+    acknowledgedAt?: number;
+    acknowledgedBy?: string;
+    createdAt: number;
+    detail?: string;
+    id: string;
+    impactedSessions: string[];
+    label: string;
+    lastSeenAt: number;
+    monitorId: string;
+    mutedAt?: number;
+    mutedBy?: string;
+    operationsRecordHrefs: string[];
+    resolvedAt?: number;
+    resolvedBy?: string;
+    severity: VoiceMonitorSeverity;
+    status: VoiceMonitorIssueStatus;
+    threshold?: number | string;
+    value?: number | string;
+};
+export type VoiceMonitorIssueStore = {
+    list: () => Promise<VoiceMonitorIssue[]> | VoiceMonitorIssue[];
+    upsert: (issue: VoiceMonitorIssue) => Promise<VoiceMonitorIssue> | VoiceMonitorIssue;
+    update: (id: string, patch: Partial<VoiceMonitorIssue>) => Promise<VoiceMonitorIssue | undefined> | VoiceMonitorIssue | undefined;
+};
+export type VoiceMonitorNotifier = {
+    deliver: (input: VoiceMonitorNotifierDeliveryInput) => Promise<VoiceMonitorNotifierDeliveryResult> | VoiceMonitorNotifierDeliveryResult;
+    id: string;
+    label: string;
+};
+export type VoiceMonitorNotifierDeliveryInput = {
+    issue: VoiceMonitorIssue;
+    now: number;
+};
+export type VoiceMonitorNotifierDeliveryResult = {
+    detail?: string;
+    status: 'failed' | 'sent' | 'skipped';
+};
+export type VoiceMonitorNotifierDeliveryReceipt = {
+    detail?: string;
+    id: string;
+    issueId: string;
+    notifierId: string;
+    notifierLabel: string;
+    sentAt: number;
+    status: 'failed' | 'sent' | 'skipped';
+};
+export type VoiceMonitorNotifierDeliveryReceiptStore = {
+    list: () => Promise<VoiceMonitorNotifierDeliveryReceipt[]> | VoiceMonitorNotifierDeliveryReceipt[];
+    set: (id: string, receipt: VoiceMonitorNotifierDeliveryReceipt) => Promise<VoiceMonitorNotifierDeliveryReceipt> | VoiceMonitorNotifierDeliveryReceipt;
+};
+export type VoiceMonitorNotifierDeliveryReport = {
+    checkedAt: number;
+    receipts: VoiceMonitorNotifierDeliveryReceipt[];
+    status: VoiceMonitorStatus;
+    summary: {
+        failed: number;
+        notifiers: number;
+        sent: number;
+        skipped: number;
+        total: number;
+    };
+};
+export type VoiceMonitorRunReport = {
+    checkedAt: number;
+    issues: VoiceMonitorIssue[];
+    runs: VoiceMonitorRun[];
+    status: VoiceMonitorStatus;
+    summary: {
+        acknowledged: number;
+        criticalOpen: number;
+        failed: number;
+        muted: number;
+        open: number;
+        passed: number;
+        resolved: number;
+        total: number;
+        warned: number;
+    };
+};
+export type VoiceMonitorRunOptions<TEvidence = unknown> = {
+    evidence: TEvidence;
+    issueStore?: VoiceMonitorIssueStore;
+    monitors: readonly VoiceMonitorDefinition<TEvidence>[];
+    now?: number;
+};
+export type VoiceMonitorNotifierDeliveryOptions = {
+    issueStore: VoiceMonitorIssueStore;
+    notifiers: readonly VoiceMonitorNotifier[];
+    now?: number;
+    receiptStore?: VoiceMonitorNotifierDeliveryReceiptStore;
+    statuses?: readonly VoiceMonitorIssueStatus[];
+};
+export type VoiceMonitorWebhookNotifierOptions = {
+    fetch?: typeof fetch;
+    headers?: HeadersInit;
+    id: string;
+    label?: string;
+    mapIssue?: (issue: VoiceMonitorIssue) => unknown;
+    url: string;
+};
+export type VoiceMonitorRoutesOptions<TEvidence = unknown> = VoiceMonitorRunOptions<TEvidence> & {
+    headers?: HeadersInit;
+    htmlPath?: false | string;
+    issuePath?: string;
+    name?: string;
+    notifierPath?: false | string;
+    notifiers?: readonly VoiceMonitorNotifier[];
+    path?: string;
+    receiptStore?: VoiceMonitorNotifierDeliveryReceiptStore;
+    render?: (report: VoiceMonitorRunReport) => Promise<string> | string;
+    title?: string;
+};
+export declare const createVoiceMemoryMonitorIssueStore: (initial?: readonly VoiceMonitorIssue[]) => VoiceMonitorIssueStore;
+export declare const createVoiceMemoryMonitorNotifierDeliveryReceiptStore: (initial?: readonly VoiceMonitorNotifierDeliveryReceipt[]) => VoiceMonitorNotifierDeliveryReceiptStore;
+export declare const buildVoiceMonitorRunReport: <TEvidence = unknown>(options: VoiceMonitorRunOptions<TEvidence>) => Promise<VoiceMonitorRunReport>;
+export declare const acknowledgeVoiceMonitorIssue: (store: VoiceMonitorIssueStore, id: string, input?: {
+    actorId?: string;
+    now?: number;
+}) => Promise<VoiceMonitorIssue | undefined>;
+export declare const resolveVoiceMonitorIssue: (store: VoiceMonitorIssueStore, id: string, input?: {
+    actorId?: string;
+    now?: number;
+}) => Promise<VoiceMonitorIssue | undefined>;
+export declare const muteVoiceMonitorIssue: (store: VoiceMonitorIssueStore, id: string, input?: {
+    actorId?: string;
+    now?: number;
+}) => Promise<VoiceMonitorIssue | undefined>;
+export declare const createVoiceMonitorWebhookNotifier: (options: VoiceMonitorWebhookNotifierOptions) => VoiceMonitorNotifier;
+export declare const deliverVoiceMonitorIssueNotifications: (options: VoiceMonitorNotifierDeliveryOptions) => Promise<VoiceMonitorNotifierDeliveryReport>;
+export declare const renderVoiceMonitorMarkdown: (report: VoiceMonitorRunReport) => string;
+export declare const renderVoiceMonitorHTML: (report: VoiceMonitorRunReport, options?: {
+    title?: string;
+}) => string;
+export declare const createVoiceMonitorRoutes: <TEvidence = unknown>(options: VoiceMonitorRoutesOptions<TEvidence>) => Elysia<"", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {
+    [x: string]: {
+        get: {
+            body: unknown;
+            params: {};
+            query: unknown;
+            headers: unknown;
+            response: {
+                200: VoiceMonitorRunReport;
+            };
+        };
+    };
+} & {
+    [x: `${string}.md`]: {
+        get: {
+            body: unknown;
+            params: {};
+            query: unknown;
+            headers: unknown;
+            response: {
+                200: Response;
+            };
+        };
+    };
+} & {
+    [x: string]: {
+        get: {
+            body: unknown;
+            params: {};
+            query: unknown;
+            headers: unknown;
+            response: {
+                200: VoiceMonitorIssue[];
+            };
+        };
+    };
+} & {
+    [x: string]: {
+        notifications: {
+            get: {
+                body: unknown;
+                params: {};
+                query: unknown;
+                headers: unknown;
+                response: {
+                    200: VoiceMonitorNotifierDeliveryReceipt[];
+                };
+            };
+        };
+    };
+} & {
+    [x: string]: {
+        ":id": {
+            acknowledge: {
+                post: {
+                    body: unknown;
+                    params: {
+                        id: string;
+                    } & {};
+                    query: unknown;
+                    headers: unknown;
+                    response: {
+                        200: Response | VoiceMonitorIssue;
+                        422: {
+                            type: "validation";
+                            on: string;
+                            summary?: string;
+                            message?: string;
+                            found?: unknown;
+                            property?: string;
+                            expected?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+} & {
+    [x: string]: {
+        ":id": {
+            resolve: {
+                post: {
+                    body: unknown;
+                    params: {
+                        id: string;
+                    } & {};
+                    query: unknown;
+                    headers: unknown;
+                    response: {
+                        200: Response | VoiceMonitorIssue;
+                        422: {
+                            type: "validation";
+                            on: string;
+                            summary?: string;
+                            message?: string;
+                            found?: unknown;
+                            property?: string;
+                            expected?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+} & {
+    [x: string]: {
+        ":id": {
+            mute: {
+                post: {
+                    body: unknown;
+                    params: {
+                        id: string;
+                    } & {};
+                    query: unknown;
+                    headers: unknown;
+                    response: {
+                        200: Response | VoiceMonitorIssue;
+                        422: {
+                            type: "validation";
+                            on: string;
+                            summary?: string;
+                            message?: string;
+                            found?: unknown;
+                            property?: string;
+                            expected?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;

package/package.json

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