@livekit/agents-plugin-cartesia 1.4.4 → 1.4.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@livekit/agents-plugin-cartesia",
-  "version": "1.4.4",
+  "version": "1.4.6",
   "description": "Cartesia plugin for LiveKit Node Agents",
   "main": "dist/index.js",
   "require": "dist/index.cjs",
@@ -25,22 +25,23 @@
     "README.md"
   ],
   "devDependencies": {
-    "@livekit/rtc-node": "^0.13.27",
+    "@livekit/rtc-node": "^0.13.29",
     "@microsoft/api-extractor": "^7.35.0",
     "@types/ws": "^8.5.10",
     "tsup": "^8.3.5",
     "typescript": "^5.0.0",
-    "@livekit/agents": "1.4.4",
-    "@livekit/agents-plugin-openai": "1.4.4",
-    "@livekit/agents-plugins-test": "1.4.4"
+    "@livekit/agents": "1.4.6",
+    "@livekit/agents-plugin-openai": "1.4.6",
+    "@livekit/agents-plugin-silero": "1.4.6",
+    "@livekit/agents-plugins-test": "1.4.6"
   },
   "dependencies": {
     "ws": "^8.18.0"
   },
   "peerDependencies": {
-    "@livekit/rtc-node": "^0.13.27",
+    "@livekit/rtc-node": "^0.13.29",
     "zod": "^3.25.76 || ^4.1.8",
-    "@livekit/agents": "1.4.4"
+    "@livekit/agents": "1.4.6"
   },
   "scripts": {
     "build": "tsup --onSuccess \"pnpm build:types\"",

package/src/index.ts

@@ -3,6 +3,7 @@
 // SPDX-License-Identifier: Apache-2.0
 import { Plugin } from '@livekit/agents';
 
+export * from './stt.js';
 export * from './tts.js';
 
 class CartesiaPlugin extends Plugin {

package/src/models.ts

@@ -2,6 +2,18 @@
 //
 // SPDX-License-Identifier: Apache-2.0
 
+/**
+ * LiveKit uses this encoding for all audio
+ */
+export const AUDIO_ENCODING = 'pcm_s16le';
+
+// ============================================================================
+//                                   TTS
+// ============================================================================
+
+/**
+ * See [the docs](https://docs.cartesia.ai/build-with-cartesia/tts-models/latest) for all options.
+ */
 export type TTSModels =
   | 'sonic'
   | 'sonic-2'
@@ -10,6 +22,9 @@ export type TTSModels =
   | 'sonic-preview'
   | 'sonic-turbo';
 
+/**
+ * See [the docs](https://docs.cartesia.ai/build-with-cartesia/tts-models/latest) for all options.
+ */
 export type TTSLanguages = 'en' | 'es' | 'fr' | 'de' | 'pt' | 'zh' | 'ja';
 
 export const TTSDefaultVoiceId = 'f786b574-daa5-4673-aa0c-cbe3e8534c02';
@@ -45,9 +60,16 @@ export type TTSVoiceEmotion =
   | 'curiosity:high'
   | 'curiosity:highest';
 
-export type TTSEncoding =
-  // XXX(nbsp): not yet supported
-  // | 'pcm_f32le'
-  // | 'pcm_mulaw'
-  // | 'pcm_alaw'
-  'pcm_s16le';
+/**
+ * @deprecated Encoding should not be parameterized. Only `pcm_s16le`is allowed. Prefer using {@link AUDIO_ENCODING}.
+ */
+export type TTSEncoding = 'pcm_s16le';
+
+// ============================================================================
+//                                   STT
+// ============================================================================
+
+/**
+ * See [the docs](https://docs.cartesia.ai/build-with-cartesia/stt-models/latest) for all options.
+ */
+export type STTModel = 'ink-2';

package/src/stt.test.ts

@@ -0,0 +1,19 @@
+// SPDX-FileCopyrightText: 2026 LiveKit, Inc.
+//
+// SPDX-License-Identifier: Apache-2.0
+import { VAD } from '@livekit/agents-plugin-silero';
+import { stt } from '@livekit/agents-plugins-test';
+import { describe, it } from 'vitest';
+import { STT } from './stt.js';
+
+const hasCartesiaApiKey = Boolean(process.env.CARTESIA_API_KEY);
+
+if (hasCartesiaApiKey) {
+  describe('Cartesia STT', async () => {
+    await stt(new STT(), await VAD.load(), { nonStreaming: false });
+  });
+} else {
+  describe('Cartesia STT', () => {
+    it.skip('requires CARTESIA_API_KEY', () => {});
+  });
+}