@absolutejs/voice 0.0.22-beta.159 → 0.0.22-beta.160
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +67 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -214,6 +214,73 @@ Recommended proof routes:
|
|
|
214
214
|
- `/live-latency`: browser-measured speech-to-assistant p50/p95 latency.
|
|
215
215
|
- `/turn-quality`: STT confidence, correction, fallback, and transcript diagnostics.
|
|
216
216
|
|
|
217
|
+
### Readiness Profiles
|
|
218
|
+
|
|
219
|
+
Use `createVoiceReadinessProfile(...)` when you want production-shaped defaults without adopting an app kit. Profiles are just spreadable route-option bundles for `createVoiceProductionReadinessRoutes(...)`; every option remains explicit and overrideable.
|
|
220
|
+
|
|
221
|
+
```ts
|
|
222
|
+
import {
|
|
223
|
+
createVoiceProductionReadinessRoutes,
|
|
224
|
+
createVoiceReadinessProfile
|
|
225
|
+
} from '@absolutejs/voice';
|
|
226
|
+
|
|
227
|
+
app.use(
|
|
228
|
+
createVoiceProductionReadinessRoutes({
|
|
229
|
+
...createVoiceReadinessProfile('meeting-recorder', {
|
|
230
|
+
bargeInReports: async () => [await buildBargeInReport()],
|
|
231
|
+
providerRoutingContracts: async () => [await runProviderRoutingContract()],
|
|
232
|
+
reconnectContracts: async () => [await runReconnectContract()]
|
|
233
|
+
}),
|
|
234
|
+
store: runtime.traces
|
|
235
|
+
})
|
|
236
|
+
);
|
|
237
|
+
```
|
|
238
|
+
|
|
239
|
+
Built-in profiles:
|
|
240
|
+
|
|
241
|
+
- `meeting-recorder`: live latency, session health, provider fallback, routing contracts, reconnect proof, and barge-in interruption proof.
|
|
242
|
+
- `phone-agent`: carrier readiness, phone-agent smoke proof, handoffs, provider routing contracts, audit/trace delivery health, and delivery runtime proof.
|
|
243
|
+
- `ops-heavy`: audit evidence, operator action history, audit/trace delivery health, delivery runtime proof, and deploy-gate support.
|
|
244
|
+
|
|
245
|
+
Phone-agent fast path:
|
|
246
|
+
|
|
247
|
+
```ts
|
|
248
|
+
app.use(
|
|
249
|
+
createVoiceProductionReadinessRoutes({
|
|
250
|
+
...createVoiceReadinessProfile('phone-agent', {
|
|
251
|
+
auditDeliveries: runtime.auditDeliveries,
|
|
252
|
+
carriers: loadCarrierMatrixInputs,
|
|
253
|
+
deliveryRuntime,
|
|
254
|
+
phoneAgentSmokes: async () => [await runPhoneSmoke()],
|
|
255
|
+
providerRoutingContracts: async () => [await runProviderRoutingContract()],
|
|
256
|
+
traceDeliveries: runtime.traceDeliveries
|
|
257
|
+
}),
|
|
258
|
+
store: runtime.traces
|
|
259
|
+
})
|
|
260
|
+
);
|
|
261
|
+
```
|
|
262
|
+
|
|
263
|
+
Ops-heavy fast path:
|
|
264
|
+
|
|
265
|
+
```ts
|
|
266
|
+
app.use(
|
|
267
|
+
createVoiceProductionReadinessRoutes({
|
|
268
|
+
...createVoiceReadinessProfile('ops-heavy', {
|
|
269
|
+
audit: runtime.audit,
|
|
270
|
+
auditDeliveries: runtime.auditDeliveries,
|
|
271
|
+
deliveryRuntime,
|
|
272
|
+
traceDeliveries: runtime.traceDeliveries
|
|
273
|
+
}),
|
|
274
|
+
gate: {
|
|
275
|
+
failOnWarnings: true
|
|
276
|
+
},
|
|
277
|
+
store: runtime.traces
|
|
278
|
+
})
|
|
279
|
+
);
|
|
280
|
+
```
|
|
281
|
+
|
|
282
|
+
The profile helper intentionally does not mount routes, create storage, start workers, or prescribe a deploy workflow. It only returns readiness options so teams can standardize defaults while keeping control over proof sources and route mounting.
|
|
283
|
+
|
|
217
284
|
## Delivery Runtime Presets
|
|
218
285
|
|
|
219
286
|
Use `createVoiceDeliveryRuntimePresetConfig(...)` when you want one primitive to create paired audit and trace delivery workers for the same target. The preset returns a normal `VoiceDeliveryRuntimeConfig`, so you can still inspect or override worker options before passing it to `createVoiceDeliveryRuntime(...)`.
|