voice-runtime 1.1.0 → 1.2.0
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 +16 -9
- package/dist/index.cjs +9776 -3143
- package/dist/index.cjs.map +4 -4
- package/dist/index.d.ts +1001 -290
- package/dist/index.js +9761 -3148
- package/dist/index.js.map +4 -4
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -16,7 +16,7 @@ for browser and phone connections.
|
|
|
16
16
|
|
|
17
17
|
## Status
|
|
18
18
|
|
|
19
|
-
`voice-runtime@1.0
|
|
19
|
+
`voice-runtime@1.1.0` is the public Node.js entry point for the TVIC runtime. It
|
|
20
20
|
supports Node.js 22, 24, and 26, ships both ESM and CommonJS entry points, and is
|
|
21
21
|
server-side only. The main CI compatibility matrix exercises all three supported
|
|
22
22
|
lines.
|
|
@@ -68,7 +68,7 @@ audio endpoint or a phone call for your application.
|
|
|
68
68
|
import { createVoiceAgent } from "voice-runtime";
|
|
69
69
|
|
|
70
70
|
const agent = createVoiceAgent({
|
|
71
|
-
prompt: "You schedule appointments for
|
|
71
|
+
prompt: "You schedule appointments for a doctor Be concise and confirm the time.",
|
|
72
72
|
providers: {
|
|
73
73
|
telephony: { provider: "web-client-audio" },
|
|
74
74
|
stt: { provider: "deepgram", apiKey: process.env.DEEPGRAM_API_KEY },
|
|
@@ -165,15 +165,18 @@ guidance are in the [provider guide](https://github.com/Kkartik14/TVIC/blob/main
|
|
|
165
165
|
|
|
166
166
|
- STT: Deepgram, Sarvam, ElevenLabs Scribe, AssemblyAI, and Soniox.
|
|
167
167
|
- LLM: Groq Chat Completions (the reference path) and an optional OpenAI Responses adapter.
|
|
168
|
-
- TTS: Cartesia and
|
|
168
|
+
- TTS: Cartesia, ElevenLabs (WebSocket, REST, and HTTP stream), and Sarvam Bulbul v3.
|
|
169
169
|
- Transport: browser audio and inbound Twilio Media Streams.
|
|
170
170
|
|
|
171
171
|
Maturity is intentionally explicit: Web Client Audio and inbound Twilio Media
|
|
172
|
-
Streams are the stable transport paths in `1.0
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
172
|
+
Streams are the stable transport paths in `1.1.0`. The paid STT, LLM, and TTS
|
|
173
|
+
adapters are currently `experimental`. `validated` is the intermediate label
|
|
174
|
+
for an exact adapter/model/configuration that has passed the small-scale live
|
|
175
|
+
evidence profile and is reasonable for low-volume use; `stable` additionally
|
|
176
|
+
requires a support matrix, release evidence, ownership, and an upgrade policy.
|
|
177
|
+
The root exports `PROVIDER_STABILITY` and `PROVIDER_STABILITY_LEVELS` contain
|
|
178
|
+
the machine-readable labels. See the provider guide for the complete evidence
|
|
179
|
+
and promotion rules.
|
|
177
180
|
|
|
178
181
|
Pass an explicit `apiKey` or use the documented environment variable. Explicit
|
|
179
182
|
credentials take precedence; missing credentials fail before a live session is
|
|
@@ -189,11 +192,15 @@ created.
|
|
|
189
192
|
| Groq | `GROQ_API_KEY` |
|
|
190
193
|
| OpenAI | `OPENAI_API_KEY` |
|
|
191
194
|
| Cartesia | `CARTESIA_API_KEY` |
|
|
195
|
+
| Sarvam TTS | `SARVAM_API_KEY` |
|
|
192
196
|
|
|
193
197
|
STT, LLM, and TTS models are independent settings. TTS voice selection is also
|
|
194
198
|
independent. Built-in TTS can read `CARTESIA_VOICE_ID` or
|
|
195
199
|
`ELEVENLABS_VOICE_ID` for its voice. For complete provider-specific control,
|
|
196
200
|
pass a constructed provider instance instead of a built-in configuration object.
|
|
201
|
+
Sarvam's managed configuration defaults to its WebSocket adapter; set
|
|
202
|
+
`transport: "rest"` or `transport: "http-stream"` on the Sarvam TTS config when
|
|
203
|
+
the downstream use case needs one-shot HTTP delivery.
|
|
197
204
|
Built-in STT and LLM configurations reject models outside the
|
|
198
205
|
dated TVIC catalog unless `allowUnknownModel: true` is explicitly set.
|
|
199
206
|
|
|
@@ -241,7 +248,7 @@ application's responsibility.
|
|
|
241
248
|
|
|
242
249
|
Advanced runtime, media, provider, normalized-error, and durable-adapter APIs
|
|
243
250
|
are exported from the package root. There are no advanced subpath imports in
|
|
244
|
-
1.0.
|
|
251
|
+
1.1.0. This lets a developer start with `createVoiceAgent` and later own
|
|
245
252
|
the runtime/session/pipeline boundaries without changing package names.
|
|
246
253
|
|
|
247
254
|
Read the [voice-agent guide](https://github.com/Kkartik14/TVIC/blob/main/docs/building-a-voice-agent.md)
|