@absolutejs/voice 0.0.22-beta.262 → 0.0.22-beta.263

package/dist/client/index.js

@@ -4299,6 +4299,58 @@ var assertVoiceLiveOpsEvidence = (input = {}) => {
   }
   return assertion;
 };
+var evaluateVoiceLiveOpsControlEvidence = (input = {}) => {
+  const issues = [];
+  const results = input.results ?? [];
+  const controls = results.map((result) => result.control).filter((control) => Boolean(control));
+  const finalControl = input.finalControl ?? controls.at(-1);
+  const actions = uniqueSorted(results.map((result) => result.action).filter((action) => isVoiceLiveOpsAction(action)));
+  const statuses = uniqueSorted(controls.map((control) => control.status));
+  const failedActions = results.filter((result) => result.ok === false).length;
+  if (results.length === 0) {
+    issues.push("Expected live-ops control action result(s) to be present.");
+  }
+  if (input.minSnapshots !== undefined && controls.length < input.minSnapshots) {
+    issues.push(`Expected at least ${String(input.minSnapshots)} live-ops control snapshot(s), found ${String(controls.length)}.`);
+  }
+  if (input.maxFailedActions !== undefined && failedActions > input.maxFailedActions) {
+    issues.push(`Expected at most ${String(input.maxFailedActions)} failed live-ops control action(s), found ${String(failedActions)}.`);
+  }
+  for (const action of findMissing(actions, input.requiredActions)) {
+    issues.push(`Missing live-ops control action: ${action}.`);
+  }
+  for (const status of findMissing(statuses, input.requiredStatuses)) {
+    issues.push(`Missing live-ops control status: ${status}.`);
+  }
+  if (!finalControl) {
+    issues.push("Expected final live-ops control state to be present.");
+  } else {
+    if (input.requireFinalAssistantPaused !== undefined && finalControl.assistantPaused !== input.requireFinalAssistantPaused) {
+      issues.push(`Expected final live-ops assistantPaused ${String(input.requireFinalAssistantPaused)}, found ${String(finalControl.assistantPaused)}.`);
+    }
+    if (input.requireFinalOperatorTakeover !== undefined && finalControl.operatorTakeover !== input.requireFinalOperatorTakeover) {
+      issues.push(`Expected final live-ops operatorTakeover ${String(input.requireFinalOperatorTakeover)}, found ${String(finalControl.operatorTakeover)}.`);
+    }
+  }
+  return {
+    actionCount: results.length,
+    actions,
+    failedActions,
+    finalControl: finalControl ?? undefined,
+    finalStatus: finalControl?.status,
+    issues,
+    ok: issues.length === 0,
+    snapshots: controls.length,
+    statuses
+  };
+};
+var assertVoiceLiveOpsControlEvidence = (input = {}) => {
+  const assertion = evaluateVoiceLiveOpsControlEvidence(input);
+  if (!assertion.ok) {
+    throw new Error(`Voice live-ops control evidence assertion failed: ${assertion.issues.join(" ")}`);
+  }
+  return assertion;
+};
 var createVoiceMemoryLiveOpsControlStore = () => {
   const states = new Map;
   return {

package/dist/index.d.ts

@@ -18,8 +18,8 @@ export { assertVoicePlatformCoverage, buildVoicePlatformCoverageSummary, createV
 export type { VoicePlatformCoverageAssertionInput, VoicePlatformCoverageAssertionReport, VoicePlatformCoverageEvidence, VoicePlatformCoverageRoutesOptions, VoicePlatformCoverageStatus, VoicePlatformCoverageSummary, VoicePlatformCoverageSummaryInput, VoicePlatformCoverageSurface } from './platformCoverage';
 export { assertVoiceProofTrendEvidence, buildEmptyVoiceProofTrendReport, buildVoiceProofTrendReport, createVoiceProofTrendRoutes, DEFAULT_VOICE_PROOF_TRENDS_MAX_AGE_MS, evaluateVoiceProofTrendEvidence, formatVoiceProofTrendAge, normalizeVoiceProofTrendReport, readVoiceProofTrendReportFile } from './proofTrends';
 export type { VoiceProofTrendAssertionInput, VoiceProofTrendAssertionReport, VoiceProofTrendCycle, VoiceProofTrendReport, VoiceProofTrendReportInput, VoiceProofTrendRoutesOptions, VoiceProofTrendStatus, VoiceProofTrendSummary } from './proofTrends';
-export { assertVoiceLiveOpsEvidence, buildVoiceLiveOpsControlState, createVoiceLiveOpsController, createVoiceLiveOpsRoutes, createVoiceMemoryLiveOpsControlStore, evaluateVoiceLiveOpsEvidence, getVoiceLiveOpsControlStatus, VOICE_LIVE_OPS_ACTIONS } from './liveOps';
-export type { VoiceLiveOpsAction, VoiceLiveOpsActionInput, VoiceLiveOpsActionResult, VoiceLiveOpsControllerOptions, VoiceLiveOpsControlState, VoiceLiveOpsControlStatus, VoiceLiveOpsControlStore, VoiceLiveOpsEvidenceInput, VoiceLiveOpsEvidenceReport, VoiceLiveOpsRoutesOptions } from './liveOps';
+export { assertVoiceLiveOpsControlEvidence, assertVoiceLiveOpsEvidence, buildVoiceLiveOpsControlState, createVoiceLiveOpsController, createVoiceLiveOpsRoutes, createVoiceMemoryLiveOpsControlStore, evaluateVoiceLiveOpsControlEvidence, evaluateVoiceLiveOpsEvidence, getVoiceLiveOpsControlStatus, VOICE_LIVE_OPS_ACTIONS } from './liveOps';
+export type { VoiceLiveOpsAction, VoiceLiveOpsActionInput, VoiceLiveOpsActionResult, VoiceLiveOpsControllerOptions, VoiceLiveOpsControlState, VoiceLiveOpsControlStatus, VoiceLiveOpsControlStore, VoiceLiveOpsControlEvidenceInput, VoiceLiveOpsControlEvidenceReport, VoiceLiveOpsEvidenceInput, VoiceLiveOpsEvidenceReport, VoiceLiveOpsRoutesOptions } from './liveOps';
 export { buildVoiceDeliveryRuntimeReport, createVoiceDeliveryRuntime, createVoiceDeliveryRuntimePresetConfig, createVoiceDeliveryRuntimeRoutes, renderVoiceDeliveryRuntimeHTML } from './deliveryRuntime';
 export { applyVoiceDataRetentionPolicy, assertVoiceDataControlEvidence, buildVoiceDataControlReport, buildVoiceDataRetentionPlan, createVoiceDataControlRoutes, createVoiceZeroRetentionPolicy, evaluateVoiceDataControlEvidence, renderVoiceDataControlHTML, renderVoiceDataControlMarkdown, voiceComplianceRedactionDefaults } from './dataControl';
 export type { VoiceDataControlAssertionInput, VoiceDataControlAssertionReport, VoiceDataControlProviderKeySurface, VoiceDataControlReport, VoiceDataControlRoutesOptions, VoiceDataControlStorageSurface, VoiceDataRetentionPolicy, VoiceDataRetentionReport, VoiceDataRetentionScope, VoiceDataRetentionScopeReport, VoiceDataRetentionStores } from './dataControl';

package/dist/index.js

@@ -12729,6 +12729,58 @@ var assertVoiceLiveOpsEvidence = (input = {}) => {
   }
   return assertion;
 };
+var evaluateVoiceLiveOpsControlEvidence = (input = {}) => {
+  const issues = [];
+  const results = input.results ?? [];
+  const controls = results.map((result) => result.control).filter((control) => Boolean(control));
+  const finalControl = input.finalControl ?? controls.at(-1);
+  const actions = uniqueSorted(results.map((result) => result.action).filter((action) => isVoiceLiveOpsAction(action)));
+  const statuses = uniqueSorted(controls.map((control) => control.status));
+  const failedActions = results.filter((result) => result.ok === false).length;
+  if (results.length === 0) {
+    issues.push("Expected live-ops control action result(s) to be present.");
+  }
+  if (input.minSnapshots !== undefined && controls.length < input.minSnapshots) {
+    issues.push(`Expected at least ${String(input.minSnapshots)} live-ops control snapshot(s), found ${String(controls.length)}.`);
+  }
+  if (input.maxFailedActions !== undefined && failedActions > input.maxFailedActions) {
+    issues.push(`Expected at most ${String(input.maxFailedActions)} failed live-ops control action(s), found ${String(failedActions)}.`);
+  }
+  for (const action of findMissing(actions, input.requiredActions)) {
+    issues.push(`Missing live-ops control action: ${action}.`);
+  }
+  for (const status of findMissing(statuses, input.requiredStatuses)) {
+    issues.push(`Missing live-ops control status: ${status}.`);
+  }
+  if (!finalControl) {
+    issues.push("Expected final live-ops control state to be present.");
+  } else {
+    if (input.requireFinalAssistantPaused !== undefined && finalControl.assistantPaused !== input.requireFinalAssistantPaused) {
+      issues.push(`Expected final live-ops assistantPaused ${String(input.requireFinalAssistantPaused)}, found ${String(finalControl.assistantPaused)}.`);
+    }
+    if (input.requireFinalOperatorTakeover !== undefined && finalControl.operatorTakeover !== input.requireFinalOperatorTakeover) {
+      issues.push(`Expected final live-ops operatorTakeover ${String(input.requireFinalOperatorTakeover)}, found ${String(finalControl.operatorTakeover)}.`);
+    }
+  }
+  return {
+    actionCount: results.length,
+    actions,
+    failedActions,
+    finalControl: finalControl ?? undefined,
+    finalStatus: finalControl?.status,
+    issues,
+    ok: issues.length === 0,
+    snapshots: controls.length,
+    statuses
+  };
+};
+var assertVoiceLiveOpsControlEvidence = (input = {}) => {
+  const assertion = evaluateVoiceLiveOpsControlEvidence(input);
+  if (!assertion.ok) {
+    throw new Error(`Voice live-ops control evidence assertion failed: ${assertion.issues.join(" ")}`);
+  }
+  return assertion;
+};
 var createVoiceMemoryLiveOpsControlStore = () => {
   const states = new Map;
   return {
@@ -31334,6 +31386,7 @@ export {
   evaluateVoiceObservabilityExportReplayEvidence,
   evaluateVoiceObservabilityExportDeliveryEvidence,
   evaluateVoiceLiveOpsEvidence,
+  evaluateVoiceLiveOpsControlEvidence,
   evaluateVoiceGuardrailPolicy,
   evaluateVoiceDataControlEvidence,
   evaluateVoiceCampaignReadinessEvidence,
@@ -31668,6 +31721,7 @@ export {
   assertVoiceObservabilityExportRecord,
   assertVoiceObservabilityExportDeliveryEvidence,
   assertVoiceLiveOpsEvidence,
+  assertVoiceLiveOpsControlEvidence,
   assertVoiceLatencySLOGate,
   assertVoiceDataControlEvidence,
   assertVoiceCampaignReadinessEvidence,

package/dist/liveOps.d.ts

@@ -69,6 +69,29 @@ export type VoiceLiveOpsEvidenceReport = {
     opsRecoveryStatus?: VoiceOpsRecoveryStatus;
     opsStatus?: VoiceOpsStatusReport['status'];
 };
+export type VoiceLiveOpsControlEvidenceInput = {
+    finalControl?: VoiceLiveOpsControlState | null;
+    maxFailedActions?: number;
+    minSnapshots?: number;
+    requireFinalAssistantPaused?: boolean;
+    requireFinalOperatorTakeover?: boolean;
+    requiredActions?: VoiceLiveOpsAction[];
+    requiredStatuses?: VoiceLiveOpsControlStatus[];
+    results?: Array<Partial<Omit<VoiceLiveOpsActionResult, 'ok'>> & {
+        ok?: boolean;
+    }>;
+};
+export type VoiceLiveOpsControlEvidenceReport = {
+    actionCount: number;
+    actions: VoiceLiveOpsAction[];
+    failedActions: number;
+    finalControl?: VoiceLiveOpsControlState;
+    finalStatus?: VoiceLiveOpsControlStatus;
+    issues: string[];
+    ok: boolean;
+    snapshots: number;
+    statuses: VoiceLiveOpsControlStatus[];
+};
 export type VoiceLiveOpsControlStore = {
     get: (sessionId: string) => Promise<VoiceLiveOpsControlState | undefined> | VoiceLiveOpsControlState | undefined;
     set: (sessionId: string, state: VoiceLiveOpsControlState) => Promise<void> | void;
@@ -93,6 +116,8 @@ export type VoiceLiveOpsRoutesOptions = VoiceLiveOpsControllerOptions & {
 };
 export declare const evaluateVoiceLiveOpsEvidence: (input?: VoiceLiveOpsEvidenceInput) => VoiceLiveOpsEvidenceReport;
 export declare const assertVoiceLiveOpsEvidence: (input?: VoiceLiveOpsEvidenceInput) => VoiceLiveOpsEvidenceReport;
+export declare const evaluateVoiceLiveOpsControlEvidence: (input?: VoiceLiveOpsControlEvidenceInput) => VoiceLiveOpsControlEvidenceReport;
+export declare const assertVoiceLiveOpsControlEvidence: (input?: VoiceLiveOpsControlEvidenceInput) => VoiceLiveOpsControlEvidenceReport;
 export declare const createVoiceMemoryLiveOpsControlStore: () => VoiceLiveOpsControlStore;
 export declare const getVoiceLiveOpsControlStatus: (action: VoiceLiveOpsAction) => VoiceLiveOpsControlStatus;
 export declare const buildVoiceLiveOpsControlState: (input: VoiceLiveOpsActionInput & {

package/dist/svelte/index.js

@@ -1837,6 +1837,58 @@ var assertVoiceLiveOpsEvidence = (input = {}) => {
   }
   return assertion;
 };
+var evaluateVoiceLiveOpsControlEvidence = (input = {}) => {
+  const issues = [];
+  const results = input.results ?? [];
+  const controls = results.map((result) => result.control).filter((control) => Boolean(control));
+  const finalControl = input.finalControl ?? controls.at(-1);
+  const actions = uniqueSorted(results.map((result) => result.action).filter((action) => isVoiceLiveOpsAction(action)));
+  const statuses = uniqueSorted(controls.map((control) => control.status));
+  const failedActions = results.filter((result) => result.ok === false).length;
+  if (results.length === 0) {
+    issues.push("Expected live-ops control action result(s) to be present.");
+  }
+  if (input.minSnapshots !== undefined && controls.length < input.minSnapshots) {
+    issues.push(`Expected at least ${String(input.minSnapshots)} live-ops control snapshot(s), found ${String(controls.length)}.`);
+  }
+  if (input.maxFailedActions !== undefined && failedActions > input.maxFailedActions) {
+    issues.push(`Expected at most ${String(input.maxFailedActions)} failed live-ops control action(s), found ${String(failedActions)}.`);
+  }
+  for (const action of findMissing(actions, input.requiredActions)) {
+    issues.push(`Missing live-ops control action: ${action}.`);
+  }
+  for (const status of findMissing(statuses, input.requiredStatuses)) {
+    issues.push(`Missing live-ops control status: ${status}.`);
+  }
+  if (!finalControl) {
+    issues.push("Expected final live-ops control state to be present.");
+  } else {
+    if (input.requireFinalAssistantPaused !== undefined && finalControl.assistantPaused !== input.requireFinalAssistantPaused) {
+      issues.push(`Expected final live-ops assistantPaused ${String(input.requireFinalAssistantPaused)}, found ${String(finalControl.assistantPaused)}.`);
+    }
+    if (input.requireFinalOperatorTakeover !== undefined && finalControl.operatorTakeover !== input.requireFinalOperatorTakeover) {
+      issues.push(`Expected final live-ops operatorTakeover ${String(input.requireFinalOperatorTakeover)}, found ${String(finalControl.operatorTakeover)}.`);
+    }
+  }
+  return {
+    actionCount: results.length,
+    actions,
+    failedActions,
+    finalControl: finalControl ?? undefined,
+    finalStatus: finalControl?.status,
+    issues,
+    ok: issues.length === 0,
+    snapshots: controls.length,
+    statuses
+  };
+};
+var assertVoiceLiveOpsControlEvidence = (input = {}) => {
+  const assertion = evaluateVoiceLiveOpsControlEvidence(input);
+  if (!assertion.ok) {
+    throw new Error(`Voice live-ops control evidence assertion failed: ${assertion.issues.join(" ")}`);
+  }
+  return assertion;
+};
 var createVoiceMemoryLiveOpsControlStore = () => {
   const states = new Map;
   return {

package/package.json

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