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

package/dist/svelte/index.js

@@ -4262,6 +4262,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) => {
@@ -4922,6 +4924,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/testing/index.js

@@ -2160,6 +2160,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) => {
@@ -2820,6 +2822,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";