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 CHANGED
@@ -16,7 +16,7 @@ for browser and phone connections.
16
16
 
17
17
  ## Status
18
18
 
19
- `voice-runtime@1.0.1` is the public Node.js entry point for the TVIC runtime. It
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 Dr. Kartik. Be concise and confirm the time.",
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 ElevenLabs.
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.1`. The paid STT, LLM,
173
- and TTS adapters are currently `experimental`. Their deterministic protocol
174
- coverage passes, but each still needs a credential-gated live-service check
175
- before release notes can call it stable. The root export `PROVIDER_STABILITY`
176
- contains the machine-readable labels.
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.1. This lets a developer start with `createVoiceAgent` and later own
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)