@livekit/agents-plugin-sarvam 1.0.45

package/dist/tts.test.cjs

@@ -0,0 +1,17 @@
+"use strict";
+var import_agents_plugin_openai = require("@livekit/agents-plugin-openai");
+var import_agents_plugins_test = require("@livekit/agents-plugins-test");
+var import_vitest = require("vitest");
+var import_tts = require("./tts.cjs");
+const hasSarvamApiKey = Boolean(process.env.SARVAM_API_KEY);
+(0, import_vitest.describe)("Sarvam TTS", () => {
+  import_vitest.it.skipIf(!hasSarvamApiKey)("runs integration suite with real API key", async () => {
+    await (0, import_agents_plugins_test.tts)(new import_tts.TTS({ apiKey: process.env.SARVAM_API_KEY }), new import_agents_plugin_openai.STT(), { streaming: false });
+  });
+  (0, import_vitest.it)("supports opting into non-streaming mode", () => {
+    const nonStreamingTts = new import_tts.TTS({ apiKey: "dummy-api-key", streaming: false });
+    (0, import_vitest.expect)(nonStreamingTts.capabilities.streaming).toBe(false);
+    (0, import_vitest.expect)(() => nonStreamingTts.stream()).toThrow(/streaming is disabled/i);
+  });
+});
+//# sourceMappingURL=tts.test.cjs.map

package/dist/tts.test.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tts.test.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { STT } from '@livekit/agents-plugin-openai';\nimport { tts } from '@livekit/agents-plugins-test';\nimport { describe, expect, it } from 'vitest';\nimport { TTS } from './tts.js';\n\nconst hasSarvamApiKey = Boolean(process.env.SARVAM_API_KEY);\n\ndescribe('Sarvam TTS', () => {\n  it.skipIf(!hasSarvamApiKey)('runs integration suite with real API key', async () => {\n    await tts(new TTS({ apiKey: process.env.SARVAM_API_KEY }), new STT(), { streaming: false });\n  });\n\n  it('supports opting into non-streaming mode', () => {\n    const nonStreamingTts = new TTS({ apiKey: 'dummy-api-key', streaming: false });\n\n    expect(nonStreamingTts.capabilities.streaming).toBe(false);\n    expect(() => nonStreamingTts.stream()).toThrow(/streaming is disabled/i);\n  });\n});\n"],"mappings":";AAGA,kCAAoB;AACpB,iCAAoB;AACpB,oBAAqC;AACrC,iBAAoB;AAEpB,MAAM,kBAAkB,QAAQ,QAAQ,IAAI,cAAc;AAAA,IAE1D,wBAAS,cAAc,MAAM;AAC3B,mBAAG,OAAO,CAAC,eAAe,EAAE,4CAA4C,YAAY;AAClF,cAAM,gCAAI,IAAI,eAAI,EAAE,QAAQ,QAAQ,IAAI,eAAe,CAAC,GAAG,IAAI,gCAAI,GAAG,EAAE,WAAW,MAAM,CAAC;AAAA,EAC5F,CAAC;AAED,wBAAG,2CAA2C,MAAM;AAClD,UAAM,kBAAkB,IAAI,eAAI,EAAE,QAAQ,iBAAiB,WAAW,MAAM,CAAC;AAE7E,8BAAO,gBAAgB,aAAa,SAAS,EAAE,KAAK,KAAK;AACzD,8BAAO,MAAM,gBAAgB,OAAO,CAAC,EAAE,QAAQ,wBAAwB;AAAA,EACzE,CAAC;AACH,CAAC;","names":[]}

package/dist/tts.test.d.cts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tts.test.d.ts.map

package/dist/tts.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tts.test.d.ts.map

package/dist/tts.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tts.test.d.ts","sourceRoot":"","sources":["../src/tts.test.ts"],"names":[],"mappings":""}

package/dist/tts.test.js

@@ -0,0 +1,16 @@
+import { STT } from "@livekit/agents-plugin-openai";
+import { tts } from "@livekit/agents-plugins-test";
+import { describe, expect, it } from "vitest";
+import { TTS } from "./tts.js";
+const hasSarvamApiKey = Boolean(process.env.SARVAM_API_KEY);
+describe("Sarvam TTS", () => {
+  it.skipIf(!hasSarvamApiKey)("runs integration suite with real API key", async () => {
+    await tts(new TTS({ apiKey: process.env.SARVAM_API_KEY }), new STT(), { streaming: false });
+  });
+  it("supports opting into non-streaming mode", () => {
+    const nonStreamingTts = new TTS({ apiKey: "dummy-api-key", streaming: false });
+    expect(nonStreamingTts.capabilities.streaming).toBe(false);
+    expect(() => nonStreamingTts.stream()).toThrow(/streaming is disabled/i);
+  });
+});
+//# sourceMappingURL=tts.test.js.map

package/dist/tts.test.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tts.test.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { STT } from '@livekit/agents-plugin-openai';\nimport { tts } from '@livekit/agents-plugins-test';\nimport { describe, expect, it } from 'vitest';\nimport { TTS } from './tts.js';\n\nconst hasSarvamApiKey = Boolean(process.env.SARVAM_API_KEY);\n\ndescribe('Sarvam TTS', () => {\n  it.skipIf(!hasSarvamApiKey)('runs integration suite with real API key', async () => {\n    await tts(new TTS({ apiKey: process.env.SARVAM_API_KEY }), new STT(), { streaming: false });\n  });\n\n  it('supports opting into non-streaming mode', () => {\n    const nonStreamingTts = new TTS({ apiKey: 'dummy-api-key', streaming: false });\n\n    expect(nonStreamingTts.capabilities.streaming).toBe(false);\n    expect(() => nonStreamingTts.stream()).toThrow(/streaming is disabled/i);\n  });\n});\n"],"mappings":"AAGA,SAAS,WAAW;AACpB,SAAS,WAAW;AACpB,SAAS,UAAU,QAAQ,UAAU;AACrC,SAAS,WAAW;AAEpB,MAAM,kBAAkB,QAAQ,QAAQ,IAAI,cAAc;AAE1D,SAAS,cAAc,MAAM;AAC3B,KAAG,OAAO,CAAC,eAAe,EAAE,4CAA4C,YAAY;AAClF,UAAM,IAAI,IAAI,IAAI,EAAE,QAAQ,QAAQ,IAAI,eAAe,CAAC,GAAG,IAAI,IAAI,GAAG,EAAE,WAAW,MAAM,CAAC;AAAA,EAC5F,CAAC;AAED,KAAG,2CAA2C,MAAM;AAClD,UAAM,kBAAkB,IAAI,IAAI,EAAE,QAAQ,iBAAiB,WAAW,MAAM,CAAC;AAE7E,WAAO,gBAAgB,aAAa,SAAS,EAAE,KAAK,KAAK;AACzD,WAAO,MAAM,gBAAgB,OAAO,CAAC,EAAE,QAAQ,wBAAwB;AAAA,EACzE,CAAC;AACH,CAAC;","names":[]}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@livekit/agents-plugin-sarvam",
+  "version": "1.0.45",
+  "description": "Sarvam AI plugin for LiveKit Node Agents",
+  "main": "dist/index.js",
+  "require": "dist/index.cjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    "import": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "require": {
+      "types": "./dist/index.d.cts",
+      "default": "./dist/index.cjs"
+    }
+  },
+  "author": "LiveKit",
+  "type": "module",
+  "repository": "git@github.com:livekit/agents-js.git",
+  "license": "Apache-2.0",
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "devDependencies": {
+    "@livekit/rtc-node": "^0.13.24",
+    "@types/ws": "^8.5.10",
+    "@microsoft/api-extractor": "^7.35.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.0.0",
+    "@livekit/agents-plugin-silero": "1.0.45",
+    "@livekit/agents-plugins-test": "1.0.45",
+    "@livekit/agents": "1.0.45",
+    "@livekit/agents-plugin-openai": "1.0.45"
+  },
+  "dependencies": {
+    "ws": "^8.16.0"
+  },
+  "peerDependencies": {
+    "@livekit/rtc-node": "^0.13.24",
+    "@livekit/agents": "1.0.45"
+  },
+  "scripts": {
+    "build": "tsup --onSuccess \"pnpm build:types\"",
+    "build:types": "tsc --declaration --emitDeclarationOnly && node ../../scripts/copyDeclarationOutput.js",
+    "clean": "rm -rf dist",
+    "clean:build": "pnpm clean && pnpm build",
+    "lint": "eslint -f unix \"src/**/*.{ts,js}\"",
+    "api:check": "api-extractor run --typescript-compiler-folder ../../node_modules/typescript",
+    "api:update": "api-extractor run --local --typescript-compiler-folder ../../node_modules/typescript --verbose"
+  }
+}

package/src/index.ts

@@ -0,0 +1,34 @@
+// SPDX-FileCopyrightText: 2025 LiveKit, Inc.
+//
+// SPDX-License-Identifier: Apache-2.0
+import { Plugin } from '@livekit/agents';
+
+export * from './models.js';
+export {
+  STT,
+  SpeechStream,
+  type STTOptions,
+  type STTV2Options,
+  type STTTranslateOptions,
+  type STTV3Options,
+} from './stt.js';
+export {
+  ChunkedStream,
+  SynthesizeStream,
+  TTS,
+  type TTSOptions,
+  type TTSV2Options,
+  type TTSV3Options,
+} from './tts.js';
+
+class SarvamPlugin extends Plugin {
+  constructor() {
+    super({
+      title: 'sarvam',
+      version: '0.1.0',
+      package: '@livekit/agents-plugin-sarvam',
+    });
+  }
+}
+
+Plugin.registerPlugin(new SarvamPlugin());

package/src/models.ts

@@ -0,0 +1,135 @@
+// SPDX-FileCopyrightText: 2025 LiveKit, Inc.
+//
+// SPDX-License-Identifier: Apache-2.0
+
+/** Supported Sarvam AI TTS models */
+export type TTSModels = 'bulbul:v2' | 'bulbul:v3';
+
+/** Speakers available on bulbul:v3 (30+ voices) */
+export type TTSV3Speakers =
+  | 'shubh'
+  | 'aditya'
+  | 'ritu'
+  | 'priya'
+  | 'neha'
+  | 'rahul'
+  | 'pooja'
+  | 'rohan'
+  | 'simran'
+  | 'kavya'
+  | 'amit'
+  | 'dev'
+  | 'ishita'
+  | 'shreya'
+  | 'ratan'
+  | 'varun'
+  | 'manan'
+  | 'sumit'
+  | 'roopa'
+  | 'kabir'
+  | 'aayan'
+  | 'ashutosh'
+  | 'advait'
+  | 'amelia'
+  | 'sophia'
+  | 'anand'
+  | 'tanya'
+  | 'tarun'
+  | 'sunny'
+  | 'mani'
+  | 'gokul'
+  | 'vijay'
+  | 'shruti'
+  | 'suhani'
+  | 'mohit'
+  | 'kavitha'
+  | 'rehan'
+  | 'soham'
+  | 'rupali';
+
+/** Speakers available on bulbul:v2 */
+export type TTSV2Speakers =
+  | 'anushka'
+  | 'manisha'
+  | 'vidya'
+  | 'arya'
+  | 'abhilash'
+  | 'karun'
+  | 'hitesh';
+
+/** All supported speakers across both models */
+export type TTSSpeakers = TTSV2Speakers | TTSV3Speakers;
+
+/** Supported language codes for Sarvam AI TTS (BCP-47) */
+export type TTSLanguages =
+  | 'bn-IN'
+  | 'en-IN'
+  | 'gu-IN'
+  | 'hi-IN'
+  | 'kn-IN'
+  | 'ml-IN'
+  | 'mr-IN'
+  | 'od-IN'
+  | 'pa-IN'
+  | 'ta-IN'
+  | 'te-IN';
+
+/** Supported output sample rates in Hz */
+export type TTSSampleRates = 8000 | 16000 | 22050 | 24000 | 32000 | 44100 | 48000;
+
+// ---------------------------------------------------------------------------
+// STT model types
+// ---------------------------------------------------------------------------
+
+/**
+ * Supported Sarvam AI STT models.
+ *
+ * @remarks
+ * - `saaras:v3` — recommended for new integrations. Supports all 22 languages, modes, and prompts.
+ * - `saaras:v2.5` — dedicated Indic-to-English translation via `/speech-to-text-translate`.
+ *   Auto-detects the source language; supports prompts but not language codes or modes.
+ * - `saarika:v2.5` — will be deprecated soon. All its languages are available in `saaras:v3`.
+ *
+ * @see {@link https://docs.sarvam.ai/api-reference-docs/getting-started/models/saaras | Saaras model docs}
+ */
+export type STTModels = 'saaras:v3' | 'saaras:v2.5' | 'saarika:v2.5';
+
+/** Transcription modes available on saaras:v3 */
+export type STTModes = 'transcribe' | 'translate' | 'verbatim' | 'translit' | 'codemix';
+
+/**
+ * Languages supported by saarika:v2.5 (11 Indian languages).
+ * All of these are also available in {@link STTV3Languages}.
+ */
+export type STTV2Languages =
+  | 'unknown'
+  | 'hi-IN'
+  | 'bn-IN'
+  | 'kn-IN'
+  | 'ml-IN'
+  | 'mr-IN'
+  | 'od-IN'
+  | 'pa-IN'
+  | 'ta-IN'
+  | 'te-IN'
+  | 'en-IN'
+  | 'gu-IN';
+
+/** saaras:v3 supports all v2 languages plus 12 additional ones (22 Indian + English) */
+export type STTV3Languages =
+  | STTV2Languages
+  | 'as-IN'
+  | 'ur-IN'
+  | 'ne-IN'
+  | 'kok-IN'
+  | 'ks-IN'
+  | 'sd-IN'
+  | 'sa-IN'
+  | 'sat-IN'
+  | 'mni-IN'
+  | 'brx-IN'
+  | 'mai-IN'
+  | 'doi-IN';
+
+/** All supported STT language codes */
+export type STTLanguages = STTV2Languages | STTV3Languages;

package/src/stt.test.ts

@@ -0,0 +1,23 @@
+// SPDX-FileCopyrightText: 2025 LiveKit, Inc.
+//
+// SPDX-License-Identifier: Apache-2.0
+import { VAD } from '@livekit/agents-plugin-silero';
+import { stt } from '@livekit/agents-plugins-test';
+import { describe, expect, it } from 'vitest';
+import { STT } from './stt.js';
+
+const hasSarvamApiKey = Boolean(process.env.SARVAM_API_KEY);
+
+describe('Sarvam STT', () => {
+  it.skipIf(!hasSarvamApiKey)('runs integration suite with real API key', async () => {
+    const vad = await VAD.load();
+    await stt(new STT({ apiKey: process.env.SARVAM_API_KEY }), vad, { streaming: false });
+  });
+
+  it('supports opting into non-streaming mode', () => {
+    const nonStreamingStt = new STT({ apiKey: 'dummy-api-key', streaming: false });
+
+    expect(nonStreamingStt.capabilities.streaming).toBe(false);
+    expect(() => nonStreamingStt.stream()).toThrow(/streaming is disabled/i);
+  });
+});