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

package/dist/index.d.ts

@@ -53,7 +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 { acknowledgeVoiceMonitorIssue, buildVoiceMonitorRunReport, createVoiceMemoryMonitorIssueStore, createVoiceMemoryMonitorNotifierDeliveryReceiptStore, createVoiceMonitorRoutes, createVoiceMonitorRunner, createVoiceMonitorRunnerRoutes, 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';
@@ -122,7 +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 { VoiceMonitorDefinition, VoiceMonitorEvaluation, VoiceMonitorEvaluationInput, VoiceMonitorIssue, VoiceMonitorIssueStatus, VoiceMonitorIssueStore, VoiceMonitorNotifier, VoiceMonitorNotifierDeliveryInput, VoiceMonitorNotifierDeliveryOptions, VoiceMonitorNotifierDeliveryReceipt, VoiceMonitorNotifierDeliveryReceiptStore, VoiceMonitorNotifierDeliveryReport, VoiceMonitorNotifierDeliveryResult, VoiceMonitorRoutesOptions, VoiceMonitorRun, VoiceMonitorRunOptions, VoiceMonitorRunReport, VoiceMonitorRunner, VoiceMonitorRunnerOptions, VoiceMonitorRunnerRoutesOptions, VoiceMonitorRunnerTickResult, 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

@@ -28746,6 +28746,61 @@ var deliverVoiceMonitorIssueNotifications = async (options) => {
     }
   };
 };
+var createVoiceMonitorRunner = (options) => {
+  const issueStore = options.issueStore ?? createVoiceMemoryMonitorIssueStore();
+  const receiptStore = options.receiptStore ?? createVoiceMemoryMonitorNotifierDeliveryReceiptStore();
+  const pollIntervalMs = options.pollIntervalMs ?? 60000;
+  let timer;
+  const loadEvidence = async () => {
+    if (options.loadEvidence) {
+      return options.loadEvidence();
+    }
+    if (options.evidence !== undefined) {
+      return options.evidence;
+    }
+    throw new Error("createVoiceMonitorRunner requires evidence or loadEvidence.");
+  };
+  const tick = async () => {
+    const startedAt = options.now?.() ?? Date.now();
+    const monitoring = await buildVoiceMonitorRunReport({
+      evidence: await loadEvidence(),
+      issueStore,
+      monitors: options.monitors,
+      now: startedAt
+    });
+    const notifierDelivery = options.notifiers ? await deliverVoiceMonitorIssueNotifications({
+      issueStore,
+      notifiers: options.notifiers,
+      now: options.now?.() ?? Date.now(),
+      receiptStore
+    }) : undefined;
+    return {
+      completedAt: options.now?.() ?? Date.now(),
+      monitoring,
+      notifierDelivery,
+      startedAt
+    };
+  };
+  return {
+    isRunning: () => timer !== undefined,
+    start: () => {
+      if (timer) {
+        return;
+      }
+      timer = setInterval(() => {
+        tick();
+      }, pollIntervalMs);
+    },
+    stop: () => {
+      if (!timer) {
+        return;
+      }
+      clearInterval(timer);
+      timer = undefined;
+    },
+    tick
+  };
+};
 var renderVoiceMonitorMarkdown = (report) => {
   const rows = report.runs.map((run) => `| ${run.id} | ${run.status} | ${run.severity} | ${run.value ?? ""} | ${run.threshold ?? ""} | ${run.detail ?? ""} |`).join(`
 `);
@@ -28839,6 +28894,24 @@ var createVoiceMonitorRoutes = (options) => {
   }
   return routes;
 };
+var createVoiceMonitorRunnerRoutes = (options) => {
+  const path = options.path ?? "/api/voice/monitor-runner";
+  return new Elysia44({
+    name: options.name ?? "absolutejs-voice-monitor-runner"
+  }).get(path, () => ({
+    isRunning: options.runner.isRunning()
+  })).post(`${path}/tick`, async () => options.runner.tick()).post(`${path}/start`, () => {
+    options.runner.start();
+    return {
+      isRunning: options.runner.isRunning()
+    };
+  }).post(`${path}/stop`, () => {
+    options.runner.stop();
+    return {
+      isRunning: options.runner.isRunning()
+    };
+  });
+};
 // src/readinessProfiles.ts
 var profileSurfaceLabels = {
   "meeting-recorder": {
@@ -32751,6 +32824,8 @@ export {
   createVoiceObservabilityExportRoutes,
   createVoiceObservabilityExportReplayRoutes,
   createVoiceMonitorWebhookNotifier,
+  createVoiceMonitorRunnerRoutes,
+  createVoiceMonitorRunner,
   createVoiceMonitorRoutes,
   createVoiceMemoryTraceSinkDeliveryStore,
   createVoiceMemoryTraceEventStore,

package/dist/voiceMonitoring.d.ts

@@ -143,6 +143,34 @@ export type VoiceMonitorRoutesOptions<TEvidence = unknown> = VoiceMonitorRunOpti
     render?: (report: VoiceMonitorRunReport) => Promise<string> | string;
     title?: string;
 };
+export type VoiceMonitorRunnerTickResult = {
+    completedAt: number;
+    monitoring: VoiceMonitorRunReport;
+    notifierDelivery?: VoiceMonitorNotifierDeliveryReport;
+    startedAt: number;
+};
+export type VoiceMonitorRunner = {
+    isRunning: () => boolean;
+    start: () => void;
+    stop: () => void;
+    tick: () => Promise<VoiceMonitorRunnerTickResult>;
+};
+export type VoiceMonitorRunnerOptions<TEvidence = unknown> = {
+    evidence?: TEvidence;
+    issueStore?: VoiceMonitorIssueStore;
+    loadEvidence?: () => Promise<TEvidence> | TEvidence;
+    monitors: readonly VoiceMonitorDefinition<TEvidence>[];
+    notifiers?: readonly VoiceMonitorNotifier[];
+    now?: () => number;
+    pollIntervalMs?: number;
+    receiptStore?: VoiceMonitorNotifierDeliveryReceiptStore;
+};
+export type VoiceMonitorRunnerRoutesOptions = {
+    headers?: HeadersInit;
+    name?: string;
+    path?: string;
+    runner: VoiceMonitorRunner;
+};
 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>;
@@ -160,6 +188,7 @@ export declare const muteVoiceMonitorIssue: (store: VoiceMonitorIssueStore, id:
 }) => Promise<VoiceMonitorIssue | undefined>;
 export declare const createVoiceMonitorWebhookNotifier: (options: VoiceMonitorWebhookNotifierOptions) => VoiceMonitorNotifier;
 export declare const deliverVoiceMonitorIssueNotifications: (options: VoiceMonitorNotifierDeliveryOptions) => Promise<VoiceMonitorNotifierDeliveryReport>;
+export declare const createVoiceMonitorRunner: <TEvidence = unknown>(options: VoiceMonitorRunnerOptions<TEvidence>) => VoiceMonitorRunner;
 export declare const renderVoiceMonitorMarkdown: (report: VoiceMonitorRunReport) => string;
 export declare const renderVoiceMonitorHTML: (report: VoiceMonitorRunReport, options?: {
     title?: string;
@@ -323,3 +352,91 @@ export declare const createVoiceMonitorRoutes: <TEvidence = unknown>(options: Vo
     standaloneSchema: {};
     response: {};
 }>;
+export declare const createVoiceMonitorRunnerRoutes: (options: VoiceMonitorRunnerRoutesOptions) => 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: {
+                    isRunning: boolean;
+                };
+            };
+        };
+    };
+} & {
+    [x: string]: {
+        tick: {
+            post: {
+                body: unknown;
+                params: {};
+                query: unknown;
+                headers: unknown;
+                response: {
+                    200: VoiceMonitorRunnerTickResult;
+                };
+            };
+        };
+    };
+} & {
+    [x: string]: {
+        start: {
+            post: {
+                body: unknown;
+                params: {};
+                query: unknown;
+                headers: unknown;
+                response: {
+                    200: {
+                        isRunning: boolean;
+                    };
+                };
+            };
+        };
+    };
+} & {
+    [x: string]: {
+        stop: {
+            post: {
+                body: unknown;
+                params: {};
+                query: unknown;
+                headers: unknown;
+                response: {
+                    200: {
+                        isRunning: boolean;
+                    };
+                };
+            };
+        };
+    };
+}, {
+    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.279",
+	"version": "0.0.22-beta.280",
 	"description": "Voice primitives and Elysia plugin for AbsoluteJS",
 	"repository": {
 		"type": "git",