@absolutejs/voice 0.0.22-beta.395 → 0.0.22-beta.397

package/dist/index.d.ts

@@ -32,9 +32,11 @@ export type { VoiceCompetitiveCoverageAssertionInput, VoiceCompetitiveCoverageAs
 export type { VoicePlatformCoverageAssertionInput, VoicePlatformCoverageAssertionReport, VoicePlatformCoverageEvidence, VoicePlatformCoverageRoutesOptions, VoicePlatformCoverageStatus, VoicePlatformCoverageSummary, VoicePlatformCoverageSummaryInput, VoicePlatformCoverageSurface } from './platformCoverage';
 export { assertVoiceProofTrendEvidence, appendVoiceRealCallProfileRecoveryEvidence, buildEmptyVoiceProofTrendReport, buildVoiceProofTrendProfileSummaries, buildVoiceProofTrendRecommendationReport, buildVoiceProofTrendReportFromRealCallProfiles, buildVoiceProofTrendReport, buildVoiceRealCallProfileEvidenceFromTraceEvents, buildVoiceRealCallProfileDefaults, buildVoiceRealCallProfileHistoryReport, buildVoiceRealCallProfileReadinessCheck, buildVoiceRealCallProfileRecoveryJobHistoryCheck, buildVoiceRealCallProfileRecoveryActions, createVoiceInMemoryRealCallProfileRecoveryJobStore, createVoiceRealCallProfileTraceCollector, createVoiceSQLiteRealCallProfileRecoveryJobStore, createVoiceProofTrendRecommendationRoutes, createVoiceProofTrendRoutes, createVoiceRealCallProfileHistoryRoutes, createVoiceRealCallProfileRecoveryActionRoutes, DEFAULT_VOICE_PROOF_TREND_PROFILE_DEFINITIONS, DEFAULT_VOICE_PROOF_TRENDS_MAX_AGE_MS, evaluateVoiceProofTrendEvidence, formatVoiceProofTrendAge, loadVoiceRealCallProfileEvidenceFromTraceStore, normalizeVoiceProofTrendReport, readVoiceProofTrendReportFile, renderVoiceProofTrendRecommendationHTML, renderVoiceProofTrendRecommendationMarkdown, renderVoiceRealCallProfileHistoryHTML, renderVoiceRealCallProfileHistoryMarkdown, runVoiceRealCallProfileRecoveryLoop, resolveVoiceRealCallProfileProviderRoute } from './proofTrends';
 export { createVoiceEvidenceAssertion, createVoiceProofAssertion, summarizeVoiceProofAssertions } from './proofAssertions';
+export { buildVoiceSessionSnapshot, buildVoiceSessionSnapshotStatus, parseVoiceSessionSnapshot } from './sessionSnapshot';
 export type { VoiceEvidenceAssertionInput, VoiceProofAssertionInput, VoiceProofAssertionResult, VoiceProofAssertionSummary } from './proofAssertions';
-export { fetchVoiceProofTarget, getVoiceProofTargetLogicalFailure, mapVoiceProofTargetsWithConcurrency, runVoiceProofTargets } from './proofRunner';
-export type { VoiceProofTarget, VoiceProofTargetMethod, VoiceProofTargetResult, VoiceProofTargetRunnerOptions, VoiceProofTargetRunOptions } from './proofRunner';
+export type { VoiceSessionSnapshot, VoiceSessionSnapshotInput, VoiceSessionSnapshotQualityEvidence, VoiceSessionSnapshotStatus } from './sessionSnapshot';
+export { fetchVoiceProofTarget, getVoiceProofTargetLogicalFailure, mapVoiceProofTargetsWithConcurrency, runVoiceCommandProofTarget, runVoiceCommandProofTargets, runVoiceProofTargets } from './proofRunner';
+export type { VoiceCommandProofExecutionResult, VoiceCommandProofTarget, VoiceCommandProofTargetResult, VoiceCommandProofTargetRunnerOptions, VoiceCommandProofTargetRunOptions, VoiceProofTarget, VoiceProofTargetMethod, VoiceProofTargetResult, VoiceProofTargetRunnerOptions, VoiceProofTargetRunOptions } from './proofRunner';
 export { applyVoiceProfileSwitchGuard, buildVoiceProfileSwitchReadinessReport, buildVoiceProfileSwitchLiveDecisionReport, createVoiceProfileSwitchLiveDecisionRoutes, createVoiceProfileSwitchPolicyProofRoutes, createVoiceProfileSwitchReadinessRoutes, recommendVoiceProfileSwitch, renderVoiceProfileSwitchLiveDecisionHTML, renderVoiceProfileSwitchPolicyProofHTML, renderVoiceProfileSwitchReadinessHTML, runVoiceProfileSwitchPolicyProof } from './profileSwitchRecommendation';
 export type { VoiceProfileSwitchGuardAction, VoiceProfileSwitchGuardDecision, VoiceProfileSwitchGuardMode, VoiceProfileSwitchGuardOptions, VoiceProfileSwitchObservedSignals, VoiceProfileSwitchLiveDecisionEvidence, VoiceProfileSwitchLiveDecisionReport, VoiceProfileSwitchLiveDecisionReportOptions, VoiceProfileSwitchLiveDecisionRoutesOptions, VoiceProfileSwitchLiveDecisionSession, VoiceProfileSwitchPolicyProofCase, VoiceProfileSwitchPolicyProofCaseResult, VoiceProfileSwitchPolicyProofOptions, VoiceProfileSwitchPolicyProofReport, VoiceProfileSwitchPolicyProofRoutesOptions, VoiceProfileSwitchReadinessIssue, VoiceProfileSwitchReadinessOptions, VoiceProfileSwitchReadinessReport, VoiceProfileSwitchReadinessRoutesOptions, VoiceProfileSwitchReadinessStatus, VoiceProfileSwitchRecommendation, VoiceProfileSwitchRecommendationOptions } from './profileSwitchRecommendation';
 export { buildVoiceProviderDecisionTraceReport, createVoiceProviderDecisionTraceEvent, createVoiceProviderDecisionTraceRoutes, listVoiceProviderDecisionTraces, renderVoiceProviderDecisionTraceHTML, renderVoiceProviderDecisionTraceMarkdown } from './providerDecisionTraces';

package/dist/index.js

@@ -18385,6 +18385,73 @@ var summarizeVoiceProofAssertions = (assertions) => {
     total: assertions.length
   };
 };
+// src/sessionSnapshot.ts
+var statusRank4 = (status) => {
+  if (status === "fail") {
+    return 2;
+  }
+  if (status === "warn") {
+    return 1;
+  }
+  return 0;
+};
+var maxStatus = (statuses) => statuses.reduce((current, status) => statusRank4(status) > statusRank4(current) ? status : current, "pass");
+var buildVoiceSessionSnapshotStatus = (input) => {
+  const statuses = [];
+  for (const media of input.media ?? []) {
+    statuses.push(media.report.status);
+  }
+  for (const quality of input.quality ?? []) {
+    if (quality.status !== undefined) {
+      statuses.push(quality.status);
+    }
+  }
+  for (const outcome of input.telephonyOutcomes ?? []) {
+    if (outcome.campaignOutcome.status === "failed") {
+      statuses.push("fail");
+    } else if (outcome.duplicate === true || !outcome.campaignOutcome.applied) {
+      statuses.push("warn");
+    }
+  }
+  if (input.proofSummary?.ok === false) {
+    statuses.push("fail");
+  }
+  return maxStatus(statuses);
+};
+var buildVoiceSessionSnapshot = (input) => {
+  const proofAssertions = [...input.proofAssertions ?? []];
+  const proofSummary = summarizeVoiceProofAssertions(proofAssertions);
+  const media = [...input.media ?? []];
+  const providerRoutingEvents = [...input.providerRoutingEvents ?? []];
+  const quality = [...input.quality ?? []];
+  const telephonyOutcomes = [...input.telephonyOutcomes ?? []];
+  return {
+    capturedAt: Date.now(),
+    media,
+    name: input.name,
+    proofAssertions,
+    proofSummary,
+    providerRoutingEvents,
+    quality,
+    scenarioId: input.scenarioId,
+    schema: "absolute.voice.session.snapshot.v1",
+    sessionId: input.sessionId,
+    status: buildVoiceSessionSnapshotStatus({
+      media,
+      proofSummary,
+      quality,
+      telephonyOutcomes
+    }),
+    telephonyOutcomes,
+    turnId: input.turnId
+  };
+};
+var parseVoiceSessionSnapshot = (snapshot) => {
+  if (snapshot.schema !== "absolute.voice.session.snapshot.v1") {
+    throw new Error("Unsupported voice session snapshot schema.");
+  }
+  return snapshot;
+};
 // src/proofRunner.ts
 var encoder = new TextEncoder;
 var trimBaseUrl = (baseUrl) => baseUrl.replace(/\/$/, "");
@@ -18549,6 +18616,54 @@ var fetchVoiceProofTarget = async (target, options) => {
   }
 };
 var runVoiceProofTargets = (targets, options) => mapVoiceProofTargetsWithConcurrency(targets, options.concurrency ?? 2, (target) => fetchVoiceProofTarget(target, options));
+var runVoiceCommandProofTarget = async (target, options) => {
+  const now = options.now ?? performance.now.bind(performance);
+  const startedAt = now();
+  const execution = await options.execute(target);
+  const stdout = execution.stdout ?? "";
+  const stderr = execution.stderr ?? "";
+  const status = execution.status;
+  const text = stdout.trim();
+  const bytes = encoder.encode(`${stdout}${stderr}`).byteLength;
+  let body = text;
+  let parseError;
+  if (text) {
+    const jsonStart = text.indexOf("{");
+    const jsonText = jsonStart >= 0 ? text.slice(jsonStart) : text;
+    try {
+      body = JSON.parse(jsonText);
+    } catch (error) {
+      parseError = error instanceof Error ? error.message : String(error);
+    }
+  }
+  await options.writeArtifact?.({
+    content: `${JSON.stringify({
+      command: target.command,
+      parseError,
+      stderr,
+      stdout,
+      status,
+      summary: parseError ? undefined : body
+    }, null, 2)}
+`,
+    name: `${safeArtifactName(target.name)}.json`,
+    target
+  });
+  const logicalFailure = !parseError ? getVoiceProofTargetLogicalFailure(body) : undefined;
+  return {
+    body,
+    bytes,
+    command: target.command,
+    elapsedMs: Math.round(now() - startedAt),
+    error: parseError ?? logicalFailure ?? (status === 0 ? undefined : stderr.trim() || `Command exited ${status}`),
+    kind: "command",
+    name: target.name,
+    ok: status === 0 && !parseError && !logicalFailure,
+    status,
+    summary: parseError ? { bytes, parseError } : summarizeValue(body)
+  };
+};
+var runVoiceCommandProofTargets = (targets, options) => mapVoiceProofTargetsWithConcurrency(targets, options.concurrency ?? targets.length, (target) => runVoiceCommandProofTarget(target, options));
 // src/providerRouterTraces.ts
 var buildVoiceProviderRouterTraceEvent = (options) => ({
   at: options.at ?? options.event.at,
@@ -28889,7 +29004,7 @@ var defaultRequirement = {
   requireFallback: false,
   requireTimeoutBudget: false
 };
-var statusRank4 = {
+var statusRank5 = {
   pass: 0,
   warn: 1,
   fail: 2
@@ -28905,7 +29020,7 @@ var surfaceProviderNames = (surface) => uniqueSorted6([
   ...isProviderList(surface.fallback) ? surface.fallback : [],
   ...isProviderList(surface.allowProviders) ? surface.allowProviders : []
 ]);
-var surfaceStatus = (issues) => issues.reduce((status, issue) => statusRank4[issue.status] > statusRank4[status] ? issue.status : status, "pass");
+var surfaceStatus = (issues) => issues.reduce((status, issue) => statusRank5[issue.status] > statusRank5[status] ? issue.status : status, "pass");
 var resolvedRequirement = (surface, options) => ({
   ...defaultRequirement,
   ...options.defaultRequirement ?? {},
@@ -29256,7 +29371,7 @@ var defaultThresholds = {
   }
 };
 var providerKinds = ["llm", "stt", "tts"];
-var statusRank5 = {
+var statusRank6 = {
   pass: 0,
   warn: 1,
   fail: 2
@@ -29452,9 +29567,9 @@ var evaluateVoiceProviderSloEvidence = (report, input = {}) => {
   const fallbacks = kindReports.reduce((total, kind) => total + kind.fallbacks, 0);
   const timeouts = kindReports.reduce((total, kind) => total + kind.timeouts, 0);
   const unresolvedErrors = kindReports.reduce((total, kind) => total + kind.unresolvedErrors, 0);
-  const maxStatus = input.maxStatus ?? "pass";
-  if (statusRank5[report.status] > statusRank5[maxStatus]) {
-    issues.push(`Expected provider SLO status at most ${maxStatus}, found ${report.status}.`);
+  const maxStatus2 = input.maxStatus ?? "pass";
+  if (statusRank6[report.status] > statusRank6[maxStatus2]) {
+    issues.push(`Expected provider SLO status at most ${maxStatus2}, found ${report.status}.`);
   }
   if (input.minEvents !== undefined && report.events < input.minEvents) {
     issues.push(`Expected at least ${String(input.minEvents)} provider routing events, found ${String(report.events)}.`);
@@ -36052,12 +36167,12 @@ var recommendVoiceProviderStack = (input) => {
   };
 };
 var rollupContractStatus = (checks) => checks.some((check) => check.status === "fail") ? "fail" : checks.some((check) => check.status === "warn") ? "warn" : "pass";
-var statusRank6 = {
+var statusRank7 = {
   pass: 0,
   warn: 1,
   fail: 2
 };
-var statusExceeds2 = (actual, max2) => statusRank6[actual] > statusRank6[max2];
+var statusExceeds2 = (actual, max2) => statusRank7[actual] > statusRank7[max2];
 var buildVoiceProviderContractMatrix = (input) => {
   const rows = input.contracts.map((contract) => {
     const configured = contract.configured !== false;
@@ -36160,7 +36275,7 @@ var buildVoiceProviderContractMatrix = (input) => {
 };
 var evaluateVoiceProviderContractMatrixEvidence = (report, input = {}) => {
   const issues = [];
-  const maxStatus = input.maxStatus ?? "pass";
+  const maxStatus2 = input.maxStatus ?? "pass";
   const maxFailed = input.maxFailed ?? 0;
   const maxWarned = input.maxWarned ?? 0;
   const minRows = input.minRows ?? 1;
@@ -36170,8 +36285,8 @@ var evaluateVoiceProviderContractMatrixEvidence = (report, input = {}) => {
   const selectedKinds = [
     ...new Set(report.rows.filter((row) => row.selected).map((row) => row.kind))
   ].sort();
-  if (statusExceeds2(report.status, maxStatus)) {
-    issues.push(`Expected provider contract matrix status at most ${maxStatus}, found ${report.status}.`);
+  if (statusExceeds2(report.status, maxStatus2)) {
+    issues.push(`Expected provider contract matrix status at most ${maxStatus2}, found ${report.status}.`);
   }
   if (report.failed > maxFailed) {
     issues.push(`Expected at most ${String(maxFailed)} failing provider contract row(s), found ${String(report.failed)}.`);
@@ -36365,15 +36480,15 @@ var evaluateVoiceProviderStackGaps = (input) => {
 };
 var evaluateVoiceProviderStackEvidence = (report, input = {}) => {
   const issues = [];
-  const maxStatus = input.maxStatus ?? "pass";
+  const maxStatus2 = input.maxStatus ?? "pass";
   const maxMissing = input.maxMissing ?? 0;
   const requireProviders = input.requireProviders ?? true;
   const kinds = [...new Set(report.gaps.map((gap) => gap.kind))].sort();
   const providers = [
     ...new Set(report.gaps.map((gap) => gap.provider).filter((provider) => provider !== undefined))
   ].sort();
-  if (statusExceeds2(report.status, maxStatus)) {
-    issues.push(`Expected provider stack status at most ${maxStatus}, found ${report.status}.`);
+  if (statusExceeds2(report.status, maxStatus2)) {
+    issues.push(`Expected provider stack status at most ${maxStatus2}, found ${report.status}.`);
   }
   if (report.missing > maxMissing) {
     issues.push(`Expected at most ${String(maxMissing)} missing provider stack capability/capabilities, found ${String(report.missing)}.`);
@@ -39552,6 +39667,8 @@ export {
   runVoiceProfileSwitchPolicyProof,
   runVoicePhoneAgentProductionSmokeContract,
   runVoiceOutcomeContractSuite,
+  runVoiceCommandProofTargets,
+  runVoiceCommandProofTarget,
   runVoiceCampaignReadinessProof,
   runVoiceCampaignProof,
   runVoiceCampaignDialerProof,
@@ -39683,6 +39800,7 @@ export {
   pruneVoiceTraceEvents,
   pruneVoiceIncidentBundleArtifacts,
   parseVoiceTelephonyWebhookEvent,
+  parseVoiceSessionSnapshot,
   normalizeVoiceProofTrendReport,
   muteVoiceMonitorIssue,
   matchesVoiceOpsTaskAssignmentRule,
@@ -40073,6 +40191,8 @@ export {
   buildVoiceTelephonyMediaReport,
   buildVoiceSloReadinessThresholdReport,
   buildVoiceSloCalibrationReport,
+  buildVoiceSessionSnapshotStatus,
+  buildVoiceSessionSnapshot,
   buildVoiceRealtimeProviderContractMatrix,
   buildVoiceRealtimeChannelRuntimeSamplesFromTrace,
   buildVoiceRealtimeChannelReport,

package/dist/proofRunner.d.ts

@@ -23,6 +23,28 @@ export type VoiceProofTargetResult = {
     summary?: Record<string, unknown>;
     url: string;
 };
+export type VoiceCommandProofTarget = {
+    command: string[];
+    kind: 'command';
+    name: string;
+};
+export type VoiceCommandProofExecutionResult = {
+    status: number;
+    stderr?: string;
+    stdout?: string;
+};
+export type VoiceCommandProofTargetResult = {
+    body?: unknown;
+    bytes: number;
+    command: string[];
+    elapsedMs: number;
+    error?: string;
+    kind: 'command';
+    name: string;
+    ok: boolean;
+    status?: number;
+    summary?: Record<string, unknown>;
+};
 export type VoiceProofTargetRunnerOptions = {
     baseUrl: string;
     fetch?: typeof fetch;
@@ -37,7 +59,21 @@ export type VoiceProofTargetRunnerOptions = {
 export type VoiceProofTargetRunOptions = VoiceProofTargetRunnerOptions & {
     concurrency?: number;
 };
+export type VoiceCommandProofTargetRunnerOptions = {
+    execute: (target: VoiceCommandProofTarget) => Promise<VoiceCommandProofExecutionResult> | VoiceCommandProofExecutionResult;
+    now?: () => number;
+    writeArtifact?: (input: {
+        content: string;
+        name: string;
+        target: VoiceCommandProofTarget;
+    }) => Promise<void> | void;
+};
+export type VoiceCommandProofTargetRunOptions = VoiceCommandProofTargetRunnerOptions & {
+    concurrency?: number;
+};
 export declare const getVoiceProofTargetLogicalFailure: (value: unknown) => "Response status is \"fail\"." | "Response pass is false." | "Response ok is false." | undefined;
 export declare const mapVoiceProofTargetsWithConcurrency: <TInput, TOutput>(items: TInput[], limit: number, mapper: (item: TInput) => Promise<TOutput>) => Promise<TOutput[]>;
 export declare const fetchVoiceProofTarget: (target: VoiceProofTarget, options: VoiceProofTargetRunnerOptions) => Promise<VoiceProofTargetResult>;
 export declare const runVoiceProofTargets: (targets: VoiceProofTarget[], options: VoiceProofTargetRunOptions) => Promise<VoiceProofTargetResult[]>;
+export declare const runVoiceCommandProofTarget: (target: VoiceCommandProofTarget, options: VoiceCommandProofTargetRunnerOptions) => Promise<VoiceCommandProofTargetResult>;
+export declare const runVoiceCommandProofTargets: (targets: VoiceCommandProofTarget[], options: VoiceCommandProofTargetRunOptions) => Promise<VoiceCommandProofTargetResult[]>;

package/dist/sessionSnapshot.d.ts

@@ -0,0 +1,44 @@
+import type { MediaProcessorGraphSnapshot } from '@absolutejs/media';
+import type { VoiceProofAssertionResult, VoiceProofAssertionSummary } from './proofAssertions';
+import type { VoiceCampaignTelephonyOutcomeSnapshot } from './campaign';
+import type { StoredVoiceTraceEvent } from './trace';
+export type VoiceSessionSnapshotStatus = 'fail' | 'pass' | 'warn';
+export type VoiceSessionSnapshotQualityEvidence = {
+    name: string;
+    report: unknown;
+    status?: VoiceSessionSnapshotStatus;
+};
+export type VoiceSessionSnapshot = {
+    capturedAt: number;
+    media: readonly MediaProcessorGraphSnapshot[];
+    name?: string;
+    proofAssertions: readonly VoiceProofAssertionResult[];
+    proofSummary: VoiceProofAssertionSummary;
+    providerRoutingEvents: readonly StoredVoiceTraceEvent[];
+    quality: readonly VoiceSessionSnapshotQualityEvidence[];
+    scenarioId?: string;
+    schema: 'absolute.voice.session.snapshot.v1';
+    sessionId: string;
+    status: VoiceSessionSnapshotStatus;
+    telephonyOutcomes: readonly VoiceCampaignTelephonyOutcomeSnapshot[];
+    turnId?: string;
+};
+export type VoiceSessionSnapshotInput = {
+    media?: readonly MediaProcessorGraphSnapshot[];
+    name?: string;
+    proofAssertions?: readonly VoiceProofAssertionResult[];
+    providerRoutingEvents?: readonly StoredVoiceTraceEvent[];
+    quality?: readonly VoiceSessionSnapshotQualityEvidence[];
+    scenarioId?: string;
+    sessionId: string;
+    telephonyOutcomes?: readonly VoiceCampaignTelephonyOutcomeSnapshot[];
+    turnId?: string;
+};
+export declare const buildVoiceSessionSnapshotStatus: (input: {
+    media?: readonly Pick<MediaProcessorGraphSnapshot, "report">[];
+    proofSummary?: Pick<VoiceProofAssertionSummary, "ok">;
+    quality?: readonly Pick<VoiceSessionSnapshotQualityEvidence, "status">[];
+    telephonyOutcomes?: readonly Pick<VoiceCampaignTelephonyOutcomeSnapshot, "campaignOutcome" | "duplicate">[];
+}) => VoiceSessionSnapshotStatus;
+export declare const buildVoiceSessionSnapshot: (input: VoiceSessionSnapshotInput) => VoiceSessionSnapshot;
+export declare const parseVoiceSessionSnapshot: (snapshot: VoiceSessionSnapshot) => VoiceSessionSnapshot;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@absolutejs/voice",
-	"version": "0.0.22-beta.395",
+	"version": "0.0.22-beta.397",
 	"description": "Voice primitives and Elysia plugin for AbsoluteJS",
 	"repository": {
 		"type": "git",
@@ -246,7 +246,7 @@
 		}
 	},
 	"dependencies": {
-		"@absolutejs/media": "0.0.1-beta.7"
+		"@absolutejs/media": "0.0.1-beta.14"
 	},
 	"devDependencies": {
 		"@absolutejs/absolute": "0.19.0-beta.646",