@absolutejs/voice 0.0.22-beta.461 → 0.0.22-beta.464

package/dist/vue/index.js

@@ -3690,7 +3690,38 @@ var resolveRealCallEvidenceRuntimeReconnectReports = async (reports, options) =>
   }
   return Array.isArray(resolved) ? resolved : [resolved];
 };
+var resolveRealCallEvidenceRuntimeSurfaceEvidence = async (source, options) => {
+  const resolved = typeof source === "function" ? await source(options) : source;
+  if (!resolved) {
+    return [];
+  }
+  return Array.isArray(resolved) ? [...resolved] : [resolved];
+};
+var createRealCallEvidenceRuntimeSessionId = (prefix, generatedAt) => `${prefix}-${Date.parse(generatedAt) || Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+var buildVoiceRealCallProfileEvidenceFromRuntimeSurface = (input, options) => {
+  const evidence = Array.isArray(input) ? input : [input];
+  return evidence.map((item) => {
+    const generatedAt = item.generatedAt ?? (options.now ?? (() => new Date))().toISOString();
+    return {
+      ...item,
+      generatedAt,
+      profileId: item.profileId ?? options.defaultProfileId,
+      providers: item.providers ? [...item.providers] : undefined,
+      sessionId: item.sessionId ?? createRealCallEvidenceRuntimeSessionId(options.defaultSessionPrefix, generatedAt),
+      surfaces: [
+        ...new Set([...item.surfaces ?? [], ...options.defaultSurfaces])
+      ].sort()
+    };
+  });
+};
+var buildVoiceRealCallProfileEvidenceFromRuntimeProviderRoles = (input, options = {}) => buildVoiceRealCallProfileEvidenceFromRuntimeSurface(input, {
+  defaultProfileId: options.defaultProfileId ?? "provider-role-evidence",
+  defaultSessionPrefix: options.defaultSessionPrefix ?? "provider-role-evidence",
+  defaultSurfaces: ["provider-path"],
+  now: options.now
+});
 var mergeRealCallEvidenceRuntimeOptions = (base, override = {}) => ({
+  browserEvidence: override.browserEvidence ?? base.browserEvidence,
   dedupe: override.dedupe ?? base.dedupe,
   evidenceStore: override.evidenceStore ?? base.evidenceStore,
   existingEvidenceLimit: override.existingEvidenceLimit ?? base.existingEvidenceLimit,
@@ -3699,6 +3730,8 @@ var mergeRealCallEvidenceRuntimeOptions = (base, override = {}) => ({
     ...override.history ?? {}
   },
   now: override.now ?? base.now,
+  phoneEvidence: override.phoneEvidence ?? base.phoneEvidence,
+  providerRoleEvidence: override.providerRoleEvidence ?? base.providerRoleEvidence,
   reconnectEvidence: {
     ...base.reconnectEvidence ?? {},
     ...override.reconnectEvidence ?? {}
@@ -3747,6 +3780,30 @@ var buildRealCallEvidenceRuntimeReport = async (options, input = {}) => {
 };
 var collectVoiceRealCallEvidenceRuntimeEvidence = async (options) => {
   const evidence = [];
+  const browserEvidence = await resolveRealCallEvidenceRuntimeSurfaceEvidence(options.browserEvidence, options);
+  if (browserEvidence.length > 0) {
+    evidence.push(...buildVoiceRealCallProfileEvidenceFromRuntimeSurface(browserEvidence, {
+      defaultProfileId: "browser-call",
+      defaultSessionPrefix: "browser-call",
+      defaultSurfaces: ["browser"],
+      now: options.now
+    }));
+  }
+  const phoneEvidence = await resolveRealCallEvidenceRuntimeSurfaceEvidence(options.phoneEvidence, options);
+  if (phoneEvidence.length > 0) {
+    evidence.push(...buildVoiceRealCallProfileEvidenceFromRuntimeSurface(phoneEvidence, {
+      defaultProfileId: "phone-agent",
+      defaultSessionPrefix: "phone-agent",
+      defaultSurfaces: ["phone", "telephony"],
+      now: options.now
+    }));
+  }
+  const providerRoleEvidence = await resolveRealCallEvidenceRuntimeSurfaceEvidence(options.providerRoleEvidence, options);
+  if (providerRoleEvidence.length > 0) {
+    evidence.push(...buildVoiceRealCallProfileEvidenceFromRuntimeProviderRoles(providerRoleEvidence, {
+      now: options.now
+    }));
+  }
   if (options.traceStore) {
     evidence.push(...buildVoiceRealCallProfileEvidenceFromTraceEvents(await options.traceStore.list({
       limit: options.traceEvidence?.limit ?? 5000
@@ -10413,6 +10470,8 @@ var serverMessageToAction = (message) => {
 };
 
 // node_modules/@absolutejs/media/dist/index.js
+import { mkdir, writeFile } from "fs/promises";
+import { join } from "path";
 var formatLabel = (format) => `${format.container}/${format.encoding}/${String(format.sampleRateHz)}hz/${String(format.channels)}ch`;
 var formatMatches = (actual, expected) => actual.container === expected.container && actual.encoding === expected.encoding && actual.sampleRateHz === expected.sampleRateHz && actual.channels === expected.channels;
 var pushIssue = (issues, severity, code, message) => {
@@ -11073,6 +11132,269 @@ var buildMediaPipelineCalibrationReport = (input = {}) => {
     turnCommitFrames: turnCommitFrames.length
   };
 };
+var DEFAULT_METADATA_DENY = [
+  "audioPayload",
+  "auth",
+  "authorization",
+  "cookie",
+  "email",
+  "phone",
+  "phoneNumber",
+  "rawPayload",
+  "secret",
+  "token",
+  "transcript",
+  "utterance"
+];
+var DEFAULT_TRUNCATE = 8;
+var issueCodes = (issues) => Array.from(new Set(issues.map((issue) => issue.code)));
+var lastEventKind = (events) => events[events.length - 1]?.kind;
+var formatOptionalMs = (value) => value === undefined ? "n/a" : `${String(Math.round(value))}ms`;
+var formatRatio = (value) => `${(value * 100).toFixed(1)}%`;
+var escapeMarkdownCell = (value) => value.replace(/\|/g, "\\|").replace(/\n/g, " ");
+var renderIssuesTable = (issues) => {
+  if (issues.length === 0) {
+    return `- No issues.
+`;
+  }
+  const rows = issues.map((issue) => `| ${issue.severity} | ${escapeMarkdownCell(issue.code)} | ${escapeMarkdownCell(issue.message)} |`).join(`
+`);
+  return `| Severity | Code | Message |
+| --- | --- | --- |
+${rows}
+`;
+};
+var summarizeMediaQualityReport = (report) => ({
+  backpressureEvents: report.backpressureEvents,
+  description: `${report.totalFrames} frame(s), ${report.gapCount} gap(s), speech ${formatRatio(report.speechRatio)}, status ${report.status}.`,
+  driftMs: report.timestampDriftMs,
+  frameCount: report.totalFrames,
+  gapCount: report.gapCount,
+  issueCodes: issueCodes(report.issues),
+  issueCount: report.issues.length,
+  jitterMs: report.jitterMs,
+  silenceRatio: report.silenceRatio,
+  speechRatio: report.speechRatio,
+  status: report.status
+});
+var summarizeMediaTransportReport = (report) => ({
+  backpressureEvents: report.backpressureEvents,
+  description: `${report.name}: ${report.state}, in ${report.inputFrames}, out ${report.outputFrames}, backpressure ${report.backpressureEvents}.`,
+  errors: report.events.filter((event) => event.kind === "error").length,
+  inputFrames: report.inputFrames,
+  lastEventKind: lastEventKind(report.events),
+  name: report.name,
+  outputFrames: report.outputFrames,
+  state: report.state,
+  status: report.status
+});
+var summarizeMediaProcessorGraphReport = (report) => {
+  const errorIssueCodes = Array.from(new Set(report.errors.map((event) => event.kind)));
+  return {
+    backpressureEvents: report.backpressure.events.length,
+    description: `${report.name}: ${report.state}, ${report.nodes.length} node(s), in ${report.inputFrames}, out ${report.emittedFrames}, dropped ${report.droppedFrames}.`,
+    droppedFrames: report.droppedFrames,
+    edgeCount: report.edges.length,
+    edgeEventCount: report.edgeEvents.length,
+    emittedFrames: report.emittedFrames,
+    errorCount: report.errors.length,
+    inputFrames: report.inputFrames,
+    issueCodes: errorIssueCodes,
+    lifecycleEventCount: report.lifecycleEvents.length,
+    name: report.name,
+    nodeCount: report.nodes.length,
+    state: report.state,
+    status: report.status,
+    timingMaxMs: report.timing.maxNodeMs
+  };
+};
+var renderMediaQualityMarkdown = (report, options = {}) => {
+  const title = options.title ?? "Media Quality Report";
+  const lines = [
+    `# ${title}`,
+    "",
+    `Status: **${report.status}**`,
+    "",
+    "| Metric | Value |",
+    "| --- | ---: |",
+    `| Total frames | ${report.totalFrames} |`,
+    `| Input audio | ${report.inputAudioFrames} |`,
+    `| Assistant audio | ${report.assistantAudioFrames} |`,
+    `| Gaps | ${report.gapCount} |`,
+    `| Jitter | ${formatOptionalMs(report.jitterMs)} |`,
+    `| Timestamp drift | ${formatOptionalMs(report.timestampDriftMs)} |`,
+    `| Speech ratio | ${formatRatio(report.speechRatio)} |`,
+    `| Silence ratio | ${formatRatio(report.silenceRatio)} |`,
+    `| Backpressure events | ${report.backpressureEvents} |`,
+    "",
+    "## Issues",
+    "",
+    renderIssuesTable(report.issues).trimEnd()
+  ];
+  return `${lines.join(`
+`)}
+`;
+};
+var renderMediaTransportMarkdown = (report, options = {}) => {
+  const title = options.title ?? `Media Transport: ${report.name}`;
+  const limit = options.redact?.truncateArraysAt ?? DEFAULT_TRUNCATE;
+  const events = report.events.slice(-limit);
+  const eventRows = events.length === 0 ? "- No transport events recorded." : ["| At | Kind | State | Buffered | Error |", "| --- | --- | --- | ---: | --- |"].concat(events.map((event) => `| ${event.at} | ${event.kind} | ${event.state} | ${event.bufferedFrames ?? ""} | ${escapeMarkdownCell(event.error ?? "")} |`)).join(`
+`);
+  const lines = [
+    `# ${title}`,
+    "",
+    `Status: **${report.status}** \xB7 State: **${report.state}**`,
+    "",
+    "| Metric | Value |",
+    "| --- | ---: |",
+    `| Input frames | ${report.inputFrames} |`,
+    `| Output frames | ${report.outputFrames} |`,
+    `| Backpressure events | ${report.backpressureEvents} |`,
+    `| Connected | ${report.connected ? "yes" : "no"} |`,
+    `| Closed | ${report.closed ? "yes" : "no"} |`,
+    `| Failed | ${report.failed ? "yes" : "no"} |`,
+    "",
+    `## Last ${events.length} event(s)`,
+    "",
+    eventRows
+  ];
+  return `${lines.join(`
+`)}
+`;
+};
+var renderMediaProcessorGraphMarkdown = (report, options = {}) => {
+  const title = options.title ?? `Media Processor Graph: ${report.name}`;
+  const limit = options.redact?.truncateArraysAt ?? DEFAULT_TRUNCATE;
+  const nodeRows = report.nodes.map((node) => `| ${escapeMarkdownCell(node.name)} | ${node.kind} | ${node.status} | ${node.inputFrames} | ${node.emittedFrames} | ${node.droppedFrames} | ${node.errors.length} |`).join(`
+`);
+  const edgeRows = report.edges.slice(0, limit).map((edge) => `| ${escapeMarkdownCell(edge.from)} | ${escapeMarkdownCell(edge.to)} | ${edge.status} | ${edge.emittedFrames} |`).join(`
+`);
+  const issues = report.errors.map((event) => ({
+    code: event.kind,
+    message: event.error ?? `Processor graph ${event.kind} (state ${event.state}).`,
+    severity: "error"
+  }));
+  const lines = [
+    `# ${title}`,
+    "",
+    `Status: **${report.status}** \xB7 State: **${report.state}**`,
+    "",
+    "| Metric | Value |",
+    "| --- | ---: |",
+    `| Nodes | ${report.nodes.length} |`,
+    `| Input frames | ${report.inputFrames} |`,
+    `| Emitted frames | ${report.emittedFrames} |`,
+    `| Dropped frames | ${report.droppedFrames} |`,
+    `| Lifecycle events | ${report.lifecycleEvents.length} |`,
+    `| Edge events | ${report.edgeEvents.length} |`,
+    `| Backpressure events | ${report.backpressure.events.length} |`,
+    `| Timing max | ${formatOptionalMs(report.timing.maxNodeMs)} |`,
+    `| Timing average | ${formatOptionalMs(report.timing.averageNodeMs)} |`,
+    "",
+    "## Nodes",
+    "",
+    nodeRows ? `| Node | Kind | Status | In | Out | Dropped | Errors |
+| --- | --- | --- | ---: | ---: | ---: | ---: |
+${nodeRows}` : "- No nodes.",
+    "",
+    `## Edges (showing up to ${limit})`,
+    "",
+    edgeRows ? `| From | To | Status | Frames |
+| --- | --- | --- | ---: |
+${edgeRows}` : "- No edges.",
+    "",
+    "## Errors",
+    "",
+    renderIssuesTable(issues).trimEnd()
+  ];
+  return `${lines.join(`
+`)}
+`;
+};
+var truncateArrays = (value, limit, seen) => {
+  if (Array.isArray(value)) {
+    const head = value.slice(0, limit).map((entry) => truncateArrays(entry, limit, seen));
+    if (value.length > limit) {
+      return [...head, { truncated: value.length - limit }];
+    }
+    return head;
+  }
+  if (value && typeof value === "object") {
+    if (seen.has(value))
+      return value;
+    seen.add(value);
+    const next = {};
+    for (const [key, entry] of Object.entries(value)) {
+      next[key] = truncateArrays(entry, limit, seen);
+    }
+    return next;
+  }
+  return value;
+};
+var applyRedaction = (value, options, seen) => {
+  const mode = options.mode ?? "omit";
+  const maskValue = options.maskValue ?? "[redacted]";
+  const allow = new Set(options.metadataAllow ?? []);
+  const deny = new Set(options.metadataDeny ?? DEFAULT_METADATA_DENY);
+  const walk = (input) => {
+    if (Array.isArray(input)) {
+      return input.map((entry) => walk(entry));
+    }
+    if (input && typeof input === "object") {
+      if (seen.has(input))
+        return input;
+      seen.add(input);
+      const next = {};
+      for (const [key, entry] of Object.entries(input)) {
+        if (allow.has(key)) {
+          next[key] = entry;
+          continue;
+        }
+        if (deny.has(key)) {
+          if (mode === "mask")
+            next[key] = maskValue;
+          continue;
+        }
+        next[key] = walk(entry);
+      }
+      return next;
+    }
+    return input;
+  };
+  return walk(value);
+};
+var redactMediaReport = (report, options = {}) => {
+  const limit = options.truncateArraysAt ?? DEFAULT_TRUNCATE;
+  const truncated = truncateArrays(report, limit, new WeakSet);
+  return applyRedaction(truncated, options, new WeakSet);
+};
+var buildArtifactPair = (report, summary, markdown, options) => {
+  const jsonValue = options.redact ? redactMediaReport(report, options.redact) : report;
+  return {
+    json: JSON.stringify(jsonValue, null, 2),
+    jsonValue,
+    markdown,
+    summary
+  };
+};
+var buildMediaQualityArtifact = (report, options = {}) => buildArtifactPair(report, summarizeMediaQualityReport(report), renderMediaQualityMarkdown(report, options), options);
+var buildMediaTransportArtifact = (report, options = {}) => buildArtifactPair(report, summarizeMediaTransportReport(report), renderMediaTransportMarkdown(report, options), options);
+var buildMediaProcessorGraphArtifact = (report, options = {}) => buildArtifactPair(report, summarizeMediaProcessorGraphReport(report), renderMediaProcessorGraphMarkdown(report, options), options);
+var writeMediaArtifact = async (input) => {
+  await mkdir(input.dir, { recursive: true });
+  const jsonPath = join(input.dir, `${input.slug}.json`);
+  const markdownPath = join(input.dir, `${input.slug}.md`);
+  await Promise.all([
+    writeFile(jsonPath, input.json, "utf8"),
+    writeFile(markdownPath, input.markdown, "utf8")
+  ]);
+  return {
+    jsonPath,
+    markdownPath,
+    summary: input.summary
+  };
+};
 
 // src/client/browserMedia.ts
 var DEFAULT_BROWSER_MEDIA_PATH = "/api/voice/browser-media";

package/dist/vue/useVoiceReadinessFailures.d.ts

@@ -71,6 +71,7 @@ export declare const useVoiceReadinessFailures: (path?: string, options?: VoiceR
             readonly resilience?: string | undefined;
             readonly sessions?: string | undefined;
             readonly sloReadinessThresholds?: string | undefined;
+            readonly sessionObservability?: string | undefined;
             readonly traceDeliveries?: string | undefined;
         };
         readonly profile?: {
@@ -445,6 +446,13 @@ export declare const useVoiceReadinessFailures: (path?: string, options?: VoiceR
                 readonly status: import("..").VoiceProductionReadinessStatus;
                 readonly total: number;
             } | undefined;
+            readonly sessionObservability?: {
+                readonly failed: number;
+                readonly passed: number;
+                readonly status: import("..").VoiceProductionReadinessStatus;
+                readonly total: number;
+                readonly warnings: number;
+            } | undefined;
             readonly quality: {
                 readonly status: "fail" | "pass";
             };
@@ -538,6 +546,7 @@ export declare const useVoiceReadinessFailures: (path?: string, options?: VoiceR
             readonly resilience?: string | undefined;
             readonly sessions?: string | undefined;
             readonly sloReadinessThresholds?: string | undefined;
+            readonly sessionObservability?: string | undefined;
             readonly traceDeliveries?: string | undefined;
         };
         readonly profile?: {
@@ -912,6 +921,13 @@ export declare const useVoiceReadinessFailures: (path?: string, options?: VoiceR
                 readonly status: import("..").VoiceProductionReadinessStatus;
                 readonly total: number;
             } | undefined;
+            readonly sessionObservability?: {
+                readonly failed: number;
+                readonly passed: number;
+                readonly status: import("..").VoiceProductionReadinessStatus;
+                readonly total: number;
+                readonly warnings: number;
+            } | undefined;
             readonly quality: {
                 readonly status: "fail" | "pass";
             };

package/package.json

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