@absolutejs/voice 0.0.22-beta.405 → 0.0.22-beta.407

package/README.md

@@ -2193,6 +2193,124 @@ For custom elements:
 </script>
 ```
 
+### Call Debugger Launch Widgets
+
+Mount `createVoiceCallDebuggerRoutes(...)` on the server, then expose a small framework-native launcher anywhere operators or developers need the latest support artifact. The launcher opens the full debugger with session snapshot, operations record, failure replay, provider path, transcript, user-heard output, linked artifacts, and incident markdown.
+
+React:
+
+```tsx
+import { VoiceCallDebuggerLaunch } from '@absolutejs/voice/react';
+
+export function DebugLatestCall() {
+	return (
+		<VoiceCallDebuggerLaunch
+			description="Open snapshot, replay, provider path, transcript, and incident markdown."
+			intervalMs={5000}
+			path="/api/voice-call-debugger/latest"
+			title="Debug Latest Call"
+		/>
+	);
+}
+```
+
+Vue:
+
+```vue
+<script setup lang="ts">
+import { VoiceCallDebuggerLaunch } from '@absolutejs/voice/vue';
+</script>
+
+<template>
+	<VoiceCallDebuggerLaunch
+		description="Open snapshot, replay, provider path, transcript, and incident markdown."
+		:interval-ms="5000"
+		path="/api/voice-call-debugger/latest"
+		title="Debug Latest Call"
+	/>
+</template>
+```
+
+Svelte:
+
+```svelte
+<script lang="ts">
+	import { onDestroy, onMount } from 'svelte';
+	import { createVoiceCallDebugger } from '@absolutejs/voice/svelte';
+
+	const debuggerLaunch = createVoiceCallDebugger('/api/voice-call-debugger/latest', {
+		description: 'Open snapshot, replay, provider path, transcript, and incident markdown.',
+		intervalMs: 5000,
+		title: 'Debug Latest Call'
+	});
+	let html = debuggerLaunch.getHTML();
+	let unsubscribe = () => {};
+
+	onMount(() => {
+		unsubscribe = debuggerLaunch.subscribe(() => {
+			html = debuggerLaunch.getHTML();
+		});
+		void debuggerLaunch.refresh().catch(() => {});
+	});
+	onDestroy(() => {
+		unsubscribe();
+		debuggerLaunch.close();
+	});
+</script>
+
+{@html html}
+```
+
+Angular:
+
+```ts
+import { Component, computed, inject } from '@angular/core';
+import { createVoiceCallDebuggerLaunchViewModel } from '@absolutejs/voice/client';
+import { VoiceCallDebuggerService } from '@absolutejs/voice/angular';
+
+@Component({
+	selector: 'app-debug-latest-call',
+	template: `
+		<a [href]="model().href">{{ model().label }}</a>
+		<p>{{ model().description }}</p>
+	`
+})
+export class DebugLatestCallComponent {
+	private readonly callDebugger = inject(VoiceCallDebuggerService).connect(
+		'/api/voice-call-debugger/latest',
+		{ intervalMs: 5000 }
+	);
+	readonly model = computed(() =>
+		createVoiceCallDebuggerLaunchViewModel(
+			'/api/voice-call-debugger/latest',
+			{
+				error: this.callDebugger.error(),
+				isLoading: this.callDebugger.isLoading(),
+				report: this.callDebugger.report(),
+				updatedAt: this.callDebugger.updatedAt()
+			},
+			{ title: 'Debug Latest Call' }
+		)
+	);
+}
+```
+
+HTML or HTMX:
+
+```html
+<absolute-voice-call-debugger-launch
+	interval-ms="5000"
+	path="/api/voice-call-debugger/latest"
+	title="Debug Latest Call"
+></absolute-voice-call-debugger-launch>
+
+<script type="module">
+	import { defineVoiceCallDebuggerLaunchElement } from '@absolutejs/voice/client';
+
+	defineVoiceCallDebuggerLaunchElement();
+</script>
+```
+
 ## Delivery Runtime Widgets
 
 After mounting `createVoiceDeliveryRuntimeRoutes(...)`, apps can expose audit and trace worker health through the same framework-native primitives:
@@ -3056,7 +3174,7 @@ Readiness emits the stable `voice.readiness.ops_recovery` gate code when unresol
 
 ## Customer-Owned Observability Export
 
-Use observability exports when a buyer wants the hosted-dashboard evidence graph, but inside their own storage, warehouse, SIEM, incident flow, or release notes. The export manifest links traces, audits, operations records, delivery queues, provider SLOs, readiness reports, screenshots, and proof-pack artifacts without making AbsoluteJS Voice the dashboard.
+Use observability exports when a buyer wants the hosted-dashboard evidence graph, but inside their own storage, warehouse, SIEM, incident flow, or release notes. The export manifest links traces, audits, operations records, session snapshots, call-debugger reports, delivery queues, provider SLOs, readiness reports, screenshots, and proof-pack artifacts without making AbsoluteJS Voice the dashboard.
 
 Every export manifest and artifact index includes a stable schema contract:
 
@@ -3169,7 +3287,10 @@ app.use(
 		audit: runtimeStorage.audit,
 		auditDeliveries: runtimeStorage.auditDeliveries,
 		links: {
-			operationsRecord: (sessionId) => `/voice-operations/${sessionId}`
+			callDebugger: (sessionId) => `/voice-call-debugger/${sessionId}`,
+			operationsRecord: (sessionId) => `/voice-operations/${sessionId}`,
+			sessionSnapshot: (sessionId) =>
+				`/api/voice/session-snapshot/${sessionId}`
 		},
 		redact: true,
 		store: runtimeStorage.traces,
@@ -3194,16 +3315,20 @@ const exportReport = await buildVoiceObservabilityExport({
 	},
 	audit: runtimeStorage.audit,
 	auditDeliveries: runtimeStorage.auditDeliveries,
+	callDebuggerReports: [latestCallDebuggerReport],
 	links: {
-		operationsRecord: (sessionId) => `/voice-operations/${sessionId}`
+		callDebugger: (sessionId) => `/voice-call-debugger/${sessionId}`,
+		operationsRecord: (sessionId) => `/voice-operations/${sessionId}`,
+		sessionSnapshot: (sessionId) => `/api/voice/session-snapshot/${sessionId}`
 	},
 	redact: true,
+	sessionSnapshots: [latestSessionSnapshot],
 	store: runtimeStorage.traces,
 	traceDeliveries: runtimeStorage.traceDeliveries
 });
 ```
 
-The route helper exposes JSON at `/api/voice/observability-export`, an artifact index at `/api/voice/observability-export/artifacts`, per-artifact downloads at `/api/voice/observability-export/artifacts/:artifactId`, delivery at `POST /api/voice/observability-export/deliveries`, delivery history at `GET /api/voice/observability-export/deliveries`, Markdown at `/voice/observability-export.md`, and HTML at `/voice/observability-export`. `createVoiceObservabilityExportReplayRoutes(...)` adds JSON replay proof at `/api/voice/observability-export/replay` and a readable replay proof page at `/voice/observability-export/replay`. Path-backed artifacts are hashed with SHA-256 by default, include byte size and freshness metadata, and can fail the export when required evidence is missing or stale. File delivery writes `manifest.json`, `artifact-index.json`, and artifact files into a customer-owned archive directory; webhook delivery posts the manifest and artifact index to a buyer-owned collector, SIEM bridge, or warehouse endpoint; S3 delivery writes the same manifest, index, and artifact files through Bun's native S3 client; SQLite and Postgres delivery persist the schema id/version, manifest, artifact index, checksum metadata, status, run id, and timestamps into buyer-owned database tables. Delivery receipt stores persist run id, destinations, status, schema, and target history so operators can prove exports have been continuously healthy. Failed trace/audit deliveries fail the export report, pending deliveries warn, and every trace/audit envelope includes the linked operations-record URL when one is configured. This is the primitive to use when customers ask how voice evidence leaves the app without going through a hosted vendor dashboard.
+The route helper exposes JSON at `/api/voice/observability-export`, an artifact index at `/api/voice/observability-export/artifacts`, per-artifact downloads at `/api/voice/observability-export/artifacts/:artifactId`, delivery at `POST /api/voice/observability-export/deliveries`, delivery history at `GET /api/voice/observability-export/deliveries`, Markdown at `/voice/observability-export.md`, and HTML at `/voice/observability-export`. `createVoiceObservabilityExportReplayRoutes(...)` adds JSON replay proof at `/api/voice/observability-export/replay` and a readable replay proof page at `/voice/observability-export/replay`. Path-backed artifacts are hashed with SHA-256 by default, include byte size and freshness metadata, and can fail the export when required evidence is missing or stale. File delivery writes `manifest.json`, `artifact-index.json`, and artifact files into a customer-owned archive directory; webhook delivery posts the manifest and artifact index to a buyer-owned collector, SIEM bridge, or warehouse endpoint; S3 delivery writes the same manifest, index, and artifact files through Bun's native S3 client; SQLite and Postgres delivery persist the schema id/version, manifest, artifact index, checksum metadata, status, run id, and timestamps into buyer-owned database tables. Delivery receipt stores persist run id, destinations, status, schema, and target history so operators can prove exports have been continuously healthy. Failed trace/audit deliveries fail the export report, pending deliveries warn, and every trace/audit envelope includes the linked operations-record URL when one is configured. Session snapshots and call-debugger reports become first-class artifact-index rows when passed through `sessionSnapshots` and `callDebuggerReports`, so support bundles, incident handoffs, SIEM records, and warehouse exports share one customer-owned evidence graph. This is the primitive to use when customers ask how voice evidence leaves the app without going through a hosted vendor dashboard.
 
 Pass the same report into production readiness when export health should block deploys:
 

package/dist/index.js

@@ -32368,6 +32368,25 @@ var createOperationArtifact = (record, href) => ({
   sessionId: record.sessionId,
   status: record.status === "failed" ? "fail" : record.status === "warning" ? "warn" : "pass"
 });
+var toSnapshotArtifactStatus = (status) => status === "fail" ? "fail" : status === "warn" ? "warn" : "pass";
+var createSessionSnapshotArtifact = (snapshot, href) => ({
+  generatedAt: snapshot.capturedAt,
+  href,
+  id: `session-snapshot:${snapshot.sessionId}`,
+  kind: "session-snapshot",
+  label: `Session snapshot ${snapshot.sessionId}`,
+  sessionId: snapshot.sessionId,
+  status: toSnapshotArtifactStatus(snapshot.status)
+});
+var createCallDebuggerArtifact = (report, href) => ({
+  generatedAt: report.checkedAt,
+  href,
+  id: `call-debugger:${report.sessionId}`,
+  kind: "call-debugger",
+  label: `Call debugger ${report.sessionId}`,
+  sessionId: report.sessionId,
+  status: report.status === "failed" ? "fail" : report.status === "warning" ? "warn" : "pass"
+});
 var unique2 = (values) => [...new Set(values)].sort();
 var stripArtifactPathAnchor = (path) => path.split("#")[0] ?? path;
 var toEpochMs = (value) => {
@@ -33027,7 +33046,9 @@ var collectSessionIds = (input) => unique2([
   ...input.sessionIds ?? [],
   ...input.events.map((event) => event.sessionId),
   ...input.auditEvents.map((event) => event.sessionId).filter((sessionId) => Boolean(sessionId)),
-  ...input.operationsRecords.map((record) => record.sessionId)
+  ...input.operationsRecords.map((record) => record.sessionId),
+  ...input.sessionSnapshots.map((snapshot) => snapshot.sessionId),
+  ...input.callDebuggerReports.map((report) => report.sessionId)
 ]);
 var collectIssues = (input) => {
   const issues = [];
@@ -33133,11 +33154,15 @@ var buildVoiceObservabilityExport = async (options = {}) => {
   const events = options.events ?? await options.store?.list() ?? [];
   const auditEvents = options.audit ? await options.audit.list() : [];
   const baseOperationsRecords = options.operationsRecords ?? [];
+  const sessionSnapshots = options.sessionSnapshots ?? [];
+  const callDebuggerReports = options.callDebuggerReports ?? [];
   const sessionIds = collectSessionIds({
     auditEvents,
+    callDebuggerReports,
     events,
     operationsRecords: baseOperationsRecords,
-    sessionIds: options.sessionIds
+    sessionIds: options.sessionIds,
+    sessionSnapshots
   });
   const shouldBuildOperationsRecords = options.includeOperationsRecords === true && options.store;
   const builtOperationsRecords = shouldBuildOperationsRecords ? await Promise.all(sessionIds.map((sessionId) => buildVoiceOperationsRecord({
@@ -33155,7 +33180,14 @@ var buildVoiceObservabilityExport = async (options = {}) => {
   const traceDeliverySummary = traceDeliveries ? await summarizeVoiceTraceSinkDeliveries(traceDeliveries) : undefined;
   const auditDeliverySummary = auditDeliveries ? await summarizeVoiceAuditSinkDeliveries(auditDeliveries) : undefined;
   const operationArtifacts = operationsRecords.map((record) => createOperationArtifact(record, options.links?.operationsRecord?.(record.sessionId)));
-  const artifacts = addArtifactDownloadHrefs(await verifyArtifacts([...operationArtifacts, ...options.artifacts ?? []], options.artifactIntegrity), options.links);
+  const sessionSnapshotArtifacts = sessionSnapshots.map((snapshot) => createSessionSnapshotArtifact(snapshot, options.links?.sessionSnapshot?.(snapshot.sessionId)));
+  const callDebuggerArtifacts = callDebuggerReports.map((report) => createCallDebuggerArtifact(report, options.links?.callDebugger?.(report.sessionId)));
+  const artifacts = addArtifactDownloadHrefs(await verifyArtifacts([
+    ...operationArtifacts,
+    ...sessionSnapshotArtifacts,
+    ...callDebuggerArtifacts,
+    ...options.artifacts ?? []
+  ], options.artifactIntegrity), options.links);
   const operationHrefBySessionId = new Map(sessionIds.map((sessionId) => [
     sessionId,
     options.links?.operationsRecord?.(sessionId)

package/dist/observabilityExport.d.ts

@@ -3,7 +3,9 @@ import type { S3Client, S3Options } from 'bun';
 import { Database } from 'bun:sqlite';
 import { type VoiceAuditSinkDeliveryQueueSummary, type VoiceAuditSinkDeliveryRecord, type VoiceAuditSinkDeliveryStore } from './auditSinks';
 import type { VoiceAuditEventStore, VoiceAuditEventType } from './audit';
+import type { VoiceCallDebuggerReport } from './callDebugger';
 import { type VoiceOperationsRecord } from './operationsRecord';
+import type { VoiceSessionSnapshot } from './sessionSnapshot';
 import { type VoiceTraceSinkDeliveryQueueSummary } from './queue';
 import { type StoredVoiceTraceEvent, type VoiceTraceEventStore, type VoiceTraceEventType, type VoiceTraceRedactionConfig, type VoiceTraceSinkDeliveryRecord, type VoiceTraceSinkDeliveryStore, type VoiceTraceSummary } from './trace';
 import type { VoicePostgresClient } from './postgresStore';
@@ -41,7 +43,7 @@ export type VoiceObservabilityExportRecordValidationOptions = {
 };
 export declare const validateVoiceObservabilityExportRecord: (input: unknown, options?: VoiceObservabilityExportRecordValidationOptions) => VoiceObservabilityExportValidationResult;
 export declare const assertVoiceObservabilityExportRecord: (input: unknown, options?: VoiceObservabilityExportRecordValidationOptions) => VoiceObservabilityExportValidationResult;
-export type VoiceObservabilityExportArtifactKind = 'incident' | 'markdown' | 'operations-record' | 'proof-pack' | 'readiness' | 'screenshot' | 'slo' | 'trace' | 'audit' | 'custom';
+export type VoiceObservabilityExportArtifactKind = 'call-debugger' | 'incident' | 'markdown' | 'operations-record' | 'proof-pack' | 'readiness' | 'screenshot' | 'session-snapshot' | 'slo' | 'trace' | 'audit' | 'custom';
 export type VoiceObservabilityExportArtifactChecksum = {
     algorithm: 'sha256';
     value: string;
@@ -380,11 +382,15 @@ export type VoiceObservabilityExportOptions = {
     includeOperationsRecords?: boolean;
     links?: {
         artifactDownload?: (artifact: VoiceObservabilityExportArtifact) => string;
+        callDebugger?: (sessionId: string) => string;
         operationsRecord?: (sessionId: string) => string;
+        sessionSnapshot?: (sessionId: string) => string;
     };
+    callDebuggerReports?: VoiceCallDebuggerReport[];
     operationsRecords?: VoiceOperationsRecord[];
     redact?: VoiceTraceRedactionConfig;
     sessionIds?: string[];
+    sessionSnapshots?: VoiceSessionSnapshot[];
     store?: VoiceTraceEventStore;
     traceDeliveries?: VoiceTraceSinkDeliveryRecord[] | VoiceTraceSinkDeliveryStore;
 };

package/package.json

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