@absolutejs/voice 0.0.22-beta.211 → 0.0.22-beta.212

package/README.md

@@ -589,6 +589,134 @@ The UI should show `/voice/campaigns`, `/voice/campaigns/observability`, `/api/v
 
 This recipe covers the hosted-platform expectations that matter for campaign outreach: recipient import evidence, consent/dedupe checks, scheduling policy, worker-safe attempts, carrier dry-run proof, webhook outcome mapping, queue observability, readiness gating, and call-log replacement links.
 
+## Use-Case Recipe: Meeting Recorder
+
+Use this path when the product needs a browser recorder for meetings, interviews, demos, or internal calls: capture microphone audio, persist transcripts and traces, generate a post-call review, expose a replayable operations record, and keep retention/export controls inside the app. This is not a hosted meeting bot; it is a set of recorder primitives your AbsoluteJS UI can own.
+
+The production shape is:
+
+1. Mount a browser voice route with persistent session, trace, review, task, and audit-capable storage.
+2. Use framework stream/controller helpers for the microphone, transcript, reconnect state, and recording status.
+3. Persist a review artifact on completion with transcript, summary, latency, outcome, and recommended follow-up.
+4. Mount trace timelines, operations records, production readiness, and data-control routes.
+5. Gate release with the `meeting-recorder` readiness profile so reconnect, barge-in/interruption, provider routing, latency, and session-health proof stay visible.
+
+```ts
+import { Elysia } from 'elysia';
+import {
+	createVoiceDataControlRoutes,
+	createVoiceFileRuntimeStorage,
+	createVoiceOperationsRecordRoutes,
+	createVoiceProductionReadinessRoutes,
+	createVoiceReadinessProfile,
+	createVoiceTraceTimelineRoutes,
+	voice,
+	voiceComplianceRedactionDefaults
+} from '@absolutejs/voice';
+import { deepgram } from '@absolutejs/voice-deepgram';
+
+const runtime = createVoiceFileRuntimeStorage({
+	directory: '.voice-runtime/meeting-recorder'
+});
+
+const app = new Elysia()
+	.use(
+		voice({
+			path: '/voice/meeting-recorder',
+			preset: 'reliability',
+			session: runtime.session,
+			stt: deepgram({
+				apiKey: process.env.DEEPGRAM_API_KEY!,
+				model: 'flux-general-en'
+			}),
+			trace: runtime.traces,
+			async onTurn({ turn }) {
+				return {
+					assistantText: '',
+					metadata: {
+						recorder: true,
+						transcript: turn.text
+					}
+				};
+			},
+			onComplete: async () => {},
+			ops: {
+				events: runtime.events,
+				reviews: runtime.reviews,
+				tasks: runtime.tasks,
+				buildReview: ({ session }) => ({
+					errors: [],
+					latencyBreakdown: [],
+					notes: ['Generated by the self-hosted meeting recorder path.'],
+					postCall: {
+						label: 'Meeting summary',
+						recommendedAction: 'Review the transcript and share action items.',
+						summary: 'Review transcript, decisions, and follow-up owners.'
+					},
+					summary: {
+						outcome: 'completed',
+						pass: true,
+						turnCount: session.turns.length
+					},
+					title: `Meeting recorder review for ${session.id}`,
+					timeline: [],
+					transcript: {
+						actual: session.turns
+							.map((turn) => turn.text)
+							.filter(Boolean)
+							.join('\n')
+					}
+				})
+			}
+		})
+	)
+	.use(
+		createVoiceTraceTimelineRoutes({
+			htmlPath: '/traces',
+			path: '/api/voice-traces',
+			store: runtime.traces
+		})
+	)
+	.use(
+		createVoiceOperationsRecordRoutes({
+			htmlPath: '/voice-operations/:sessionId',
+			integrationEvents: runtime.events,
+			path: '/api/voice-operations/:sessionId',
+			reviews: runtime.reviews,
+			store: runtime.traces,
+			tasks: runtime.tasks
+		})
+	)
+	.use(
+		createVoiceDataControlRoutes({
+			...runtime,
+			audit: runtime.audit,
+			auditDeliveries: runtime.auditDeliveries,
+			redact: voiceComplianceRedactionDefaults,
+			traceDeliveries: runtime.traceDeliveries
+		})
+	)
+	.use(
+		createVoiceProductionReadinessRoutes({
+			...createVoiceReadinessProfile('meeting-recorder', {
+				explain: true
+			}),
+			links: {
+				dataControl: '/data-control',
+				operationsRecords: '/voice-operations/:sessionId',
+				traces: '/traces'
+			},
+			store: runtime.traces
+		})
+	);
+```
+
+The UI should show a clear recording button, elapsed time, live transcript, reconnect state, recording status, a stop/finalize action, and links to `/voice-operations/:sessionId`, `/traces`, `/production-readiness`, and `/data-control`. Use `useVoiceStream(...)`, `useVoiceController(...)`, `createVoiceStream(...)`, `VoiceStreamService`, or the HTML/HTMX client helpers depending on the framework; the route and trace/review stores stay the same.
+
+For customer-facing exports, use the same redaction/export primitives as support workflows: render trace Markdown or audit Markdown with `voiceComplianceRedactionDefaults`, then deliver it through file, webhook, or S3 delivery runtimes. For sensitive recordings, start with a retention dry run through `/data-control/retention/plan` before applying deletion.
+
+This recipe covers the hosted-platform expectations that matter for meeting recorders: browser mic capture, live transcript UI, reconnect visibility, post-call review, transcript/debug record, readiness proof, customer-owned storage, retention controls, and redacted export paths.
+
 ## How This Differs From Hosted Voice Platforms
 
 Hosted voice-agent platforms are strongest when you want a managed dashboard, phone-number provisioning, hosted orchestration, and campaign tooling out of the box.

package/package.json

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