@livekit/agents-plugin-openai 0.9.1 → 0.9.2

package/dist/stt.d.cts

@@ -0,0 +1,43 @@
+import { type AudioBuffer, stt } from '@livekit/agents';
+import { OpenAI } from 'openai';
+import type { GroqAudioModels, WhisperModels } from './models.js';
+export interface STTOptions {
+    apiKey?: string;
+    language: string;
+    prompt?: string;
+    detectLanguage: boolean;
+    model: WhisperModels | string;
+    baseURL?: string;
+    client?: OpenAI;
+}
+export declare class STT extends stt.STT {
+    #private;
+    label: string;
+    /**
+     * Create a new instance of OpenAI STT.
+     *
+     * @remarks
+     * `apiKey` must be set to your OpenAI API key, either using the argument or by setting the
+     * `OPENAI_API_KEY` environmental variable.
+     */
+    constructor(opts?: Partial<STTOptions>);
+    /**
+     * Create a new instance of Groq STT.
+     *
+     * @remarks
+     * `apiKey` must be set to your Groq API key, either using the argument or by setting the
+     * `GROQ_API_KEY` environmental variable.
+     */
+    static withGroq(opts?: Partial<{
+        model: string | GroqAudioModels;
+        apiKey?: string;
+        baseURL?: string;
+        client: OpenAI;
+        language: string;
+        detectLanguage: boolean;
+    }>): STT;
+    _recognize(buffer: AudioBuffer, language?: string): Promise<stt.SpeechEvent>;
+    /** This method throws an error; streaming is unsupported on OpenAI STT. */
+    stream(): stt.SpeechStream;
+}
+//# sourceMappingURL=stt.d.ts.map

package/dist/stt.test.d.cts

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

package/dist/tts.d.cts

@@ -0,0 +1,37 @@
+import { tts } from '@livekit/agents';
+import { OpenAI } from 'openai';
+import type { TTSModels, TTSVoices } from './models.js';
+export interface TTSOptions {
+    model: TTSModels | string;
+    voice: TTSVoices;
+    speed: number;
+    instructions?: string;
+    baseURL?: string;
+    client?: OpenAI;
+    apiKey?: string;
+}
+export declare class TTS extends tts.TTS {
+    #private;
+    label: string;
+    /**
+     * Create a new instance of OpenAI TTS.
+     *
+     * @remarks
+     * `apiKey` must be set to your OpenAI API key, either using the argument or by setting the
+     * `OPENAI_API_KEY` environmental variable.
+     */
+    constructor(opts?: Partial<TTSOptions>);
+    updateOptions(opts: {
+        model?: TTSModels | string;
+        voice?: TTSVoices;
+        speed?: number;
+    }): void;
+    synthesize(text: string): ChunkedStream;
+    stream(): tts.SynthesizeStream;
+}
+export declare class ChunkedStream extends tts.ChunkedStream {
+    #private;
+    label: string;
+    constructor(tts: TTS, text: string, stream: Promise<any>);
+}
+//# sourceMappingURL=tts.d.ts.map

package/dist/tts.test.d.cts

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

package/package.json

@@ -1,15 +1,18 @@
 {
   "name": "@livekit/agents-plugin-openai",
-  "version": "0.9.1",
+  "version": "0.9.2",
   "description": "OpenAI 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",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
+      "default": "./dist/index.js"
+    },
+    "require": {
+      "types": "./dist/index.d.cts",
+      "default": "./dist/index.cjs"
     }
   },
   "author": "LiveKit",
@@ -25,7 +28,7 @@
     "@livekit/agents": "^x",
     "@livekit/agents-plugin-silero": "^x",
     "@livekit/agents-plugins-test": "^x",
-    "@livekit/rtc-node": "^0.13.4",
+    "@livekit/rtc-node": "^0.13.11",
     "@microsoft/api-extractor": "^7.35.0",
     "@types/ws": "^8.5.10",
     "tsup": "^8.3.5",
@@ -37,11 +40,12 @@
     "ws": "^8.16.0"
   },
   "peerDependencies": {
-    "@livekit/rtc-node": "^0.13.4",
-    "@livekit/agents": "^0.7.2x"
+    "@livekit/rtc-node": "^0.13.11",
+    "@livekit/agents": "^0.7.7x"
   },
   "scripts": {
-    "build": "tsup --onSuccess \"tsc --declaration --emitDeclarationOnly\"",
+    "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}\"",

package/src/llm.ts

@@ -10,6 +10,7 @@ import type {
   ChatModels,
   DeepSeekChatModels,
   GroqChatModels,
+  MetaChatModels,
   OctoChatModels,
   PerplexityChatModels,
   TelnyxChatModels,
@@ -382,6 +383,36 @@ export class LLM extends llm.LLM {
     });
   }
 
+  /**
+   * Create a new instance of Meta Llama LLM.
+   *
+   * @remarks
+   * `apiKey` must be set to your Meta Llama API key, either using the argument or by setting the
+   * `LLAMA_API_KEY` environmental variable.
+   */
+  static withMeta(
+    opts: Partial<{
+      apiKey?: string;
+      baseURL?: string;
+      client?: OpenAI;
+      model?: string | MetaChatModels;
+      temperature?: number;
+      user?: string;
+    }> = {},
+  ): LLM {
+    opts.apiKey = opts.apiKey || process.env.LLAMA_API_KEY;
+    opts.baseURL = opts.baseURL || 'https://api.llama.com/compat/v1/';
+    opts.model = opts.model || 'Llama-4-Maverick-17B-128E-Instruct-FP8';
+
+    if (opts.apiKey === undefined) {
+      throw new Error(
+        'Meta Llama API key is required, either as argument or set LLAMA_API_KEY environmental variable',
+      );
+    }
+
+    return new LLM(opts);
+  }
+
   chat({
     chatCtx,
     fncCtx,

package/src/models.ts

@@ -128,3 +128,9 @@ export type OctoChatModels =
   | 'wizardlm-2-8x22bllamaguard-2-7b';
 
 export type XAIChatModels = 'grok-2' | 'grok-2-mini' | 'grok-2-mini-public' | 'grok-2-public';
+
+export type MetaChatModels =
+  | 'Llama-4-Scout-17B-16E-Instruct-FP8'
+  | 'Llama-4-Maverick-17B-128E-Instruct-FP8'
+  | 'Llama-3.3-70B-Instruct'
+  | 'Llama-3.3-8B-Instruct';