@livekit/agents-plugin-assemblyai 0.0.0-next-20260624041820

package/dist/stt.test.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/stt.test.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2026 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { VAD } from '@livekit/agents-plugin-silero';\nimport { stt } from '@livekit/agents-plugins-test';\nimport { describe, expect, it } from 'vitest';\nimport { STT } from './stt.js';\n\ndescribe('AssemblyAI options', () => {\n  it('accepts u3-rt-pro-beta-1', () => {\n    const stt = new STT({ apiKey: 'test-key', speechModel: 'u3-rt-pro-beta-1' });\n\n    expect(stt.model).toBe('u3-rt-pro-beta-1');\n  });\n\n  it('accepts u3-pro parameters for u3-rt-pro-beta-1', () => {\n    expect(\n      () =>\n        new STT({\n          apiKey: 'test-key',\n          speechModel: 'u3-rt-pro-beta-1',\n          prompt: 'medical dictation',\n          agentContext: \"The agent asked for the patient's name.\",\n          previousContextNTurns: 10,\n        }),\n    ).not.toThrow();\n  });\n\n  it('requires a u3-rt-pro model for agentContext', () => {\n    expect(\n      () =>\n        new STT({\n          apiKey: 'test-key',\n          speechModel: 'universal-streaming-english',\n          agentContext: 'hello',\n        }),\n    ).toThrow(/agentContext/);\n  });\n\n  it('requires a u3-rt-pro model for previousContextNTurns', () => {\n    expect(\n      () =>\n        new STT({\n          apiKey: 'test-key',\n          speechModel: 'universal-streaming-english',\n          previousContextNTurns: 5,\n        }),\n    ).toThrow(/previousContextNTurns/);\n  });\n});\n\nconst hasAssemblyAIApiKey = Boolean(process.env.ASSEMBLYAI_API_KEY);\n\nif (hasAssemblyAIApiKey) {\n  describe('AssemblyAI', async () => {\n    await stt(new STT(), await VAD.load(), { nonStreaming: false });\n  });\n} else {\n  describe('AssemblyAI', () => {\n    it.skip('requires ASSEMBLYAI_API_KEY', () => {});\n  });\n}\n"],"mappings":";AAGA,kCAAoB;AACpB,iCAAoB;AACpB,oBAAqC;AACrC,iBAAoB;AAAA,IAEpB,wBAAS,sBAAsB,MAAM;AACnC,wBAAG,4BAA4B,MAAM;AACnC,UAAMA,OAAM,IAAI,eAAI,EAAE,QAAQ,YAAY,aAAa,mBAAmB,CAAC;AAE3E,8BAAOA,KAAI,KAAK,EAAE,KAAK,kBAAkB;AAAA,EAC3C,CAAC;AAED,wBAAG,kDAAkD,MAAM;AACzD;AAAA,MACE,MACE,IAAI,eAAI;AAAA,QACN,QAAQ;AAAA,QACR,aAAa;AAAA,QACb,QAAQ;AAAA,QACR,cAAc;AAAA,QACd,uBAAuB;AAAA,MACzB,CAAC;AAAA,IACL,EAAE,IAAI,QAAQ;AAAA,EAChB,CAAC;AAED,wBAAG,+CAA+C,MAAM;AACtD;AAAA,MACE,MACE,IAAI,eAAI;AAAA,QACN,QAAQ;AAAA,QACR,aAAa;AAAA,QACb,cAAc;AAAA,MAChB,CAAC;AAAA,IACL,EAAE,QAAQ,cAAc;AAAA,EAC1B,CAAC;AAED,wBAAG,wDAAwD,MAAM;AAC/D;AAAA,MACE,MACE,IAAI,eAAI;AAAA,QACN,QAAQ;AAAA,QACR,aAAa;AAAA,QACb,uBAAuB;AAAA,MACzB,CAAC;AAAA,IACL,EAAE,QAAQ,uBAAuB;AAAA,EACnC,CAAC;AACH,CAAC;AAED,MAAM,sBAAsB,QAAQ,QAAQ,IAAI,kBAAkB;AAElE,IAAI,qBAAqB;AACvB,8BAAS,cAAc,YAAY;AACjC,cAAM,gCAAI,IAAI,eAAI,GAAG,MAAM,gCAAI,KAAK,GAAG,EAAE,cAAc,MAAM,CAAC;AAAA,EAChE,CAAC;AACH,OAAO;AACL,8BAAS,cAAc,MAAM;AAC3B,qBAAG,KAAK,+BAA+B,MAAM;AAAA,IAAC,CAAC;AAAA,EACjD,CAAC;AACH;","names":["stt"]}

package/dist/stt.test.d.cts

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

package/dist/stt.test.d.ts

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

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

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

package/dist/stt.test.js

@@ -0,0 +1,51 @@
+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";
+describe("AssemblyAI options", () => {
+  it("accepts u3-rt-pro-beta-1", () => {
+    const stt2 = new STT({ apiKey: "test-key", speechModel: "u3-rt-pro-beta-1" });
+    expect(stt2.model).toBe("u3-rt-pro-beta-1");
+  });
+  it("accepts u3-pro parameters for u3-rt-pro-beta-1", () => {
+    expect(
+      () => new STT({
+        apiKey: "test-key",
+        speechModel: "u3-rt-pro-beta-1",
+        prompt: "medical dictation",
+        agentContext: "The agent asked for the patient's name.",
+        previousContextNTurns: 10
+      })
+    ).not.toThrow();
+  });
+  it("requires a u3-rt-pro model for agentContext", () => {
+    expect(
+      () => new STT({
+        apiKey: "test-key",
+        speechModel: "universal-streaming-english",
+        agentContext: "hello"
+      })
+    ).toThrow(/agentContext/);
+  });
+  it("requires a u3-rt-pro model for previousContextNTurns", () => {
+    expect(
+      () => new STT({
+        apiKey: "test-key",
+        speechModel: "universal-streaming-english",
+        previousContextNTurns: 5
+      })
+    ).toThrow(/previousContextNTurns/);
+  });
+});
+const hasAssemblyAIApiKey = Boolean(process.env.ASSEMBLYAI_API_KEY);
+if (hasAssemblyAIApiKey) {
+  describe("AssemblyAI", async () => {
+    await stt(new STT(), await VAD.load(), { nonStreaming: false });
+  });
+} else {
+  describe("AssemblyAI", () => {
+    it.skip("requires ASSEMBLYAI_API_KEY", () => {
+    });
+  });
+}
+//# sourceMappingURL=stt.test.js.map

package/dist/stt.test.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/stt.test.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2026 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { VAD } from '@livekit/agents-plugin-silero';\nimport { stt } from '@livekit/agents-plugins-test';\nimport { describe, expect, it } from 'vitest';\nimport { STT } from './stt.js';\n\ndescribe('AssemblyAI options', () => {\n  it('accepts u3-rt-pro-beta-1', () => {\n    const stt = new STT({ apiKey: 'test-key', speechModel: 'u3-rt-pro-beta-1' });\n\n    expect(stt.model).toBe('u3-rt-pro-beta-1');\n  });\n\n  it('accepts u3-pro parameters for u3-rt-pro-beta-1', () => {\n    expect(\n      () =>\n        new STT({\n          apiKey: 'test-key',\n          speechModel: 'u3-rt-pro-beta-1',\n          prompt: 'medical dictation',\n          agentContext: \"The agent asked for the patient's name.\",\n          previousContextNTurns: 10,\n        }),\n    ).not.toThrow();\n  });\n\n  it('requires a u3-rt-pro model for agentContext', () => {\n    expect(\n      () =>\n        new STT({\n          apiKey: 'test-key',\n          speechModel: 'universal-streaming-english',\n          agentContext: 'hello',\n        }),\n    ).toThrow(/agentContext/);\n  });\n\n  it('requires a u3-rt-pro model for previousContextNTurns', () => {\n    expect(\n      () =>\n        new STT({\n          apiKey: 'test-key',\n          speechModel: 'universal-streaming-english',\n          previousContextNTurns: 5,\n        }),\n    ).toThrow(/previousContextNTurns/);\n  });\n});\n\nconst hasAssemblyAIApiKey = Boolean(process.env.ASSEMBLYAI_API_KEY);\n\nif (hasAssemblyAIApiKey) {\n  describe('AssemblyAI', async () => {\n    await stt(new STT(), await VAD.load(), { nonStreaming: false });\n  });\n} else {\n  describe('AssemblyAI', () => {\n    it.skip('requires ASSEMBLYAI_API_KEY', () => {});\n  });\n}\n"],"mappings":"AAGA,SAAS,WAAW;AACpB,SAAS,WAAW;AACpB,SAAS,UAAU,QAAQ,UAAU;AACrC,SAAS,WAAW;AAEpB,SAAS,sBAAsB,MAAM;AACnC,KAAG,4BAA4B,MAAM;AACnC,UAAMA,OAAM,IAAI,IAAI,EAAE,QAAQ,YAAY,aAAa,mBAAmB,CAAC;AAE3E,WAAOA,KAAI,KAAK,EAAE,KAAK,kBAAkB;AAAA,EAC3C,CAAC;AAED,KAAG,kDAAkD,MAAM;AACzD;AAAA,MACE,MACE,IAAI,IAAI;AAAA,QACN,QAAQ;AAAA,QACR,aAAa;AAAA,QACb,QAAQ;AAAA,QACR,cAAc;AAAA,QACd,uBAAuB;AAAA,MACzB,CAAC;AAAA,IACL,EAAE,IAAI,QAAQ;AAAA,EAChB,CAAC;AAED,KAAG,+CAA+C,MAAM;AACtD;AAAA,MACE,MACE,IAAI,IAAI;AAAA,QACN,QAAQ;AAAA,QACR,aAAa;AAAA,QACb,cAAc;AAAA,MAChB,CAAC;AAAA,IACL,EAAE,QAAQ,cAAc;AAAA,EAC1B,CAAC;AAED,KAAG,wDAAwD,MAAM;AAC/D;AAAA,MACE,MACE,IAAI,IAAI;AAAA,QACN,QAAQ;AAAA,QACR,aAAa;AAAA,QACb,uBAAuB;AAAA,MACzB,CAAC;AAAA,IACL,EAAE,QAAQ,uBAAuB;AAAA,EACnC,CAAC;AACH,CAAC;AAED,MAAM,sBAAsB,QAAQ,QAAQ,IAAI,kBAAkB;AAElE,IAAI,qBAAqB;AACvB,WAAS,cAAc,YAAY;AACjC,UAAM,IAAI,IAAI,IAAI,GAAG,MAAM,IAAI,KAAK,GAAG,EAAE,cAAc,MAAM,CAAC;AAAA,EAChE,CAAC;AACH,OAAO;AACL,WAAS,cAAc,MAAM;AAC3B,OAAG,KAAK,+BAA+B,MAAM;AAAA,IAAC,CAAC;AAAA,EACjD,CAAC;AACH;","names":["stt"]}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@livekit/agents-plugin-assemblyai",
+  "version": "0.0.0-next-20260624041820",
+  "description": "AssemblyAI 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"
+  ],
+  "devDependencies": {
+    "@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": "0.0.0-next-20260624041820",
+    "@livekit/agents-plugins-test": "0.0.0-next-20260624041820",
+    "@livekit/agents-plugin-silero": "0.0.0-next-20260624041820"
+  },
+  "dependencies": {
+    "ws": "^8.16.0"
+  },
+  "peerDependencies": {
+    "@livekit/rtc-node": "^0.13.29",
+    "@livekit/agents": "0.0.0-next-20260624041820"
+  },
+  "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,19 @@
+// SPDX-FileCopyrightText: 2026 LiveKit, Inc.
+//
+// SPDX-License-Identifier: Apache-2.0
+import { Plugin } from '@livekit/agents';
+
+export * from './models.js';
+export * from './stt.js';
+
+class AssemblyAIPlugin extends Plugin {
+  constructor() {
+    super({
+      title: 'assemblyai',
+      version: __PACKAGE_VERSION__,
+      package: __PACKAGE_NAME__,
+    });
+  }
+}
+
+Plugin.registerPlugin(new AssemblyAIPlugin());

package/src/models.ts

@@ -0,0 +1,18 @@
+// SPDX-FileCopyrightText: 2026 LiveKit, Inc.
+//
+// SPDX-License-Identifier: Apache-2.0
+
+export type STTModels =
+  | 'universal-streaming-english'
+  | 'universal-streaming-multilingual'
+  | 'u3-rt-pro'
+  | 'u3-rt-pro-beta-1'
+  | 'universal-3-5-pro'
+  // Deprecated alias — AssemblyAI maps this to `u3-rt-pro` server-side, but the
+  // Python plugin emits a warning and rewrites it. Kept here so TS users don't
+  // break if they already pass it.
+  | 'u3-pro';
+
+export type STTEncoding = 'pcm_s16le' | 'pcm_mulaw';
+
+export type VoiceFocus = 'near-field' | 'far-field';

package/src/stt.test.ts

@@ -0,0 +1,62 @@
+// 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, expect, it } from 'vitest';
+import { STT } from './stt.js';
+
+describe('AssemblyAI options', () => {
+  it('accepts u3-rt-pro-beta-1', () => {
+    const stt = new STT({ apiKey: 'test-key', speechModel: 'u3-rt-pro-beta-1' });
+
+    expect(stt.model).toBe('u3-rt-pro-beta-1');
+  });
+
+  it('accepts u3-pro parameters for u3-rt-pro-beta-1', () => {
+    expect(
+      () =>
+        new STT({
+          apiKey: 'test-key',
+          speechModel: 'u3-rt-pro-beta-1',
+          prompt: 'medical dictation',
+          agentContext: "The agent asked for the patient's name.",
+          previousContextNTurns: 10,
+        }),
+    ).not.toThrow();
+  });
+
+  it('requires a u3-rt-pro model for agentContext', () => {
+    expect(
+      () =>
+        new STT({
+          apiKey: 'test-key',
+          speechModel: 'universal-streaming-english',
+          agentContext: 'hello',
+        }),
+    ).toThrow(/agentContext/);
+  });
+
+  it('requires a u3-rt-pro model for previousContextNTurns', () => {
+    expect(
+      () =>
+        new STT({
+          apiKey: 'test-key',
+          speechModel: 'universal-streaming-english',
+          previousContextNTurns: 5,
+        }),
+    ).toThrow(/previousContextNTurns/);
+  });
+});
+
+const hasAssemblyAIApiKey = Boolean(process.env.ASSEMBLYAI_API_KEY);
+
+if (hasAssemblyAIApiKey) {
+  describe('AssemblyAI', async () => {
+    await stt(new STT(), await VAD.load(), { nonStreaming: false });
+  });
+} else {
+  describe('AssemblyAI', () => {
+    it.skip('requires ASSEMBLYAI_API_KEY', () => {});
+  });
+}