feat(plugins): add Gnani STT

.changeset/quiet-dragons-shake.md

@@ -0,0 +1,5 @@
+---
+'@livekit/agents-plugin-gnani': patch
+---
+
+Add Gnani Vachana STT plugin.

README.md

@@ -64,6 +64,7 @@ Currently, only the following plugins are supported:
 | [@livekit/agents-plugin-openai](https://www.npmjs.com/package/@livekit/agents-plugin-openai)         | LLM, TTS, STT |
 | [@livekit/agents-plugin-google](https://www.npmjs.com/package/@livekit/agents-plugin-google)         | LLM, TTS      |
 | [@livekit/agents-plugin-deepgram](https://www.npmjs.com/package/@livekit/agents-plugin-deepgram)     | STT, TTS      |
+| [@livekit/agents-plugin-gnani](https://www.npmjs.com/package/@livekit/agents-plugin-gnani)           | STT           |
 | [@livekit/agents-plugin-elevenlabs](https://www.npmjs.com/package/@livekit/agents-plugin-elevenlabs) | TTS           |
 | [@livekit/agents-plugin-cartesia](https://www.npmjs.com/package/@livekit/agents-plugin-cartesia)     | TTS           |
 | [@livekit/agents-plugin-neuphonic](https://www.npmjs.com/package/@livekit/agents-plugin-neuphonic)   | TTS           |

plugins/gnani/CHANGELOG.md

@@ -0,0 +1,7 @@
+# @livekit/agents-plugin-gnani
+
+## 1.4.4
+
+### Patch Changes
+
+- Initial release.

plugins/gnani/README.md

@@ -0,0 +1,37 @@
+<!--
+SPDX-FileCopyrightText: 2026 LiveKit, Inc.
+
+SPDX-License-Identifier: Apache-2.0
+-->
+
+# agents-plugin-gnani
+
+[Gnani Vachana](https://gnani.ai/) plugin for [LiveKit Agents](https://docs.livekit.io/agents/).
+
+Provides speech-to-text (STT) for Indian languages using Gnani's Vachana API.
+
+## Installation
+
+```bash
+pnpm add @livekit/agents-plugin-gnani
+```
+
+## Usage
+
+```typescript
+import * as gnani from '@livekit/agents-plugin-gnani';
+
+const stt = new gnani.STT({
+  language: 'hi-IN',
+});
+```
+
+Set the `GNANI_API_KEY` environment variable or pass `apiKey` directly.
+
+For REST recognition, `GNANI_ORGANIZATION_ID` and `GNANI_USER_ID` may also be set or passed directly.
+
+## Supported Languages
+
+Bengali (`bn-IN`), English India (`en-IN`), Gujarati (`gu-IN`), Hindi (`hi-IN`), Kannada (`kn-IN`), Malayalam (`ml-IN`), Marathi (`mr-IN`), Punjabi (`pa-IN`), Tamil (`ta-IN`), Telugu (`te-IN`).
+
+Streaming also supports code-switching language codes `en-hi-IN-latn` and `en-hi-in-cm`.

plugins/gnani/api-extractor.json

@@ -0,0 +1,8 @@
+/**
+ * Config file for API Extractor.  For more info, please visit: https://api-extractor.com
+ */
+{
+  "$schema": "https://developer.microsoft.com/json-schemas/api-extractor/v7/api-extractor.schema.json",
+  "extends": "../../api-extractor-shared.json",
+  "mainEntryPointFilePath": "./dist/index.d.ts"
+}

plugins/gnani/etc/agents-plugin-gnani.api.md

@@ -0,0 +1,56 @@
+## API Report File for "@livekit/agents-plugin-gnani"
+
+> Do not edit this file. It is a report generated by [API Extractor](https://api-extractor.com/).
+
+```ts
+
+import { APIConnectOptions } from '@livekit/agents';
+import { AudioBuffer as AudioBuffer_2 } from '@livekit/agents';
+import { stt } from '@livekit/agents';
+
+// @public (undocumented)
+export type GnaniSTTLanguages = 'bn-IN' | 'en-IN' | 'gu-IN' | 'hi-IN' | 'kn-IN' | 'ml-IN' | 'mr-IN' | 'pa-IN' | 'ta-IN' | 'te-IN' | 'en-IN,hi-IN' | 'en-hi-IN-latn' | 'en-hi-in-cm';
+
+// @public (undocumented)
+export class SpeechStream extends stt.SpeechStream {
+    constructor(sttInstance: STT, opts: Partial<STTOptions>, connOptions?: APIConnectOptions);
+    // (undocumented)
+    label: string;
+    // (undocumented)
+    protected run(): Promise<void>;
+    // (undocumented)
+    updateOptions(opts: Partial<STTOptions>): void;
+}
+
+// @public (undocumented)
+export class STT extends stt.STT {
+    constructor(opts?: Partial<STTOptions>);
+    // (undocumented)
+    label: string;
+    // (undocumented)
+    get model(): string;
+    // (undocumented)
+    get provider(): string;
+    // (undocumented)
+    _recognize(buffer: AudioBuffer_2, abortSignal?: AbortSignal): Promise<stt.SpeechEvent>;
+    // (undocumented)
+    stream(options?: {
+        connOptions?: APIConnectOptions;
+    }): SpeechStream;
+    // (undocumented)
+    updateOptions(opts: Partial<STTOptions>): void;
+}
+
+// @public (undocumented)
+export interface STTOptions {
+    apiKey?: string;
+    baseUrl: string;
+    language: GnaniSTTLanguages | string;
+    organizationId?: string;
+    sampleRate: number;
+    userId?: string;
+}
+
+// (No @packageDocumentation comment for this package)
+
+```

plugins/gnani/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@livekit/agents-plugin-gnani",
+  "version": "1.4.4",
+  "description": "Gnani Vachana plugin for LiveKit Agents for Node.js",
+  "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"
+  ],
+  "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"
+  },
+  "devDependencies": {
+    "@livekit/agents": "workspace:*",
+    "@livekit/rtc-node": "catalog:",
+    "@microsoft/api-extractor": "^7.35.0",
+    "@types/ws": "catalog:",
+    "tsup": "^8.3.5",
+    "typescript": "^5.0.0"
+  },
+  "dependencies": {
+    "ws": "catalog:"
+  },
+  "peerDependencies": {
+    "@livekit/agents": "workspace:*",
+    "@livekit/rtc-node": "catalog:"
+  }
+}

plugins/gnani/src/index.ts

@@ -0,0 +1,18 @@
+// SPDX-FileCopyrightText: 2026 LiveKit, Inc.
+//
+// SPDX-License-Identifier: Apache-2.0
+import { Plugin } from '@livekit/agents';
+
+export * from './stt.js';
+
+class GnaniPlugin extends Plugin {
+  constructor() {
+    super({
+      title: 'gnani',
+      version: __PACKAGE_VERSION__,
+      package: __PACKAGE_NAME__,
+    });
+  }
+}
+
+Plugin.registerPlugin(new GnaniPlugin());