@livekit/agents 1.0.36-dev.0 → 1.0.37

package/src/voice/testing/types.ts

@@ -0,0 +1,118 @@
+// SPDX-FileCopyrightText: 2025 LiveKit, Inc.
+//
+// SPDX-License-Identifier: Apache-2.0
+import type {
+  AgentHandoffItem,
+  ChatMessage,
+  ChatRole,
+  FunctionCall,
+  FunctionCallOutput,
+} from '../../llm/chat_context.js';
+import type { Agent } from '../agent.js';
+
+/**
+ * Event representing an assistant or user message in the conversation.
+ */
+export interface ChatMessageEvent {
+  type: 'message';
+  item: ChatMessage;
+}
+
+/**
+ * Event representing a function/tool call initiated by the LLM.
+ */
+export interface FunctionCallEvent {
+  type: 'function_call';
+  item: FunctionCall;
+}
+
+/**
+ * Event representing the output/result of a function call.
+ */
+export interface FunctionCallOutputEvent {
+  type: 'function_call_output';
+  item: FunctionCallOutput;
+}
+
+/**
+ * Event representing an agent handoff (switching from one agent to another).
+ */
+export interface AgentHandoffEvent {
+  type: 'agent_handoff';
+  item: AgentHandoffItem;
+  oldAgent?: Agent;
+  newAgent: Agent;
+}
+
+/**
+ * Union type of all possible run events that can occur during a test run.
+ */
+export type RunEvent =
+  | ChatMessageEvent
+  | FunctionCallEvent
+  | FunctionCallOutputEvent
+  | AgentHandoffEvent;
+
+/**
+ * Type guard to check if an event is a ChatMessageEvent.
+ */
+export function isChatMessageEvent(event: RunEvent): event is ChatMessageEvent {
+  return event.type === 'message';
+}
+
+/**
+ * Type guard to check if an event is a FunctionCallEvent.
+ */
+export function isFunctionCallEvent(event: RunEvent): event is FunctionCallEvent {
+  return event.type === 'function_call';
+}
+
+/**
+ * Type guard to check if an event is a FunctionCallOutputEvent.
+ */
+export function isFunctionCallOutputEvent(event: RunEvent): event is FunctionCallOutputEvent {
+  return event.type === 'function_call_output';
+}
+
+/**
+ * Type guard to check if an event is an AgentHandoffEvent.
+ */
+export function isAgentHandoffEvent(event: RunEvent): event is AgentHandoffEvent {
+  return event.type === 'agent_handoff';
+}
+
+/**
+ * Options for message assertion.
+ */
+export interface MessageAssertOptions {
+  role?: ChatRole;
+}
+
+/**
+ * Options for function call assertion.
+ */
+export interface FunctionCallAssertOptions {
+  name?: string;
+  args?: Record<string, unknown>;
+}
+
+/**
+ * Options for function call output assertion.
+ */
+export interface FunctionCallOutputAssertOptions {
+  output?: string;
+  isError?: boolean;
+}
+
+/**
+ * Options for agent handoff assertion.
+ */
+export interface AgentHandoffAssertOptions {
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  newAgentType?: new (...args: any[]) => Agent;
+}
+
+/**
+ * Event type literals for type-safe event filtering.
+ */
+export type EventType = 'message' | 'function_call' | 'function_call_output' | 'agent_handoff';

package/dist/inference/interruption/AdaptiveInterruptionDetector.cjs

@@ -1,152 +0,0 @@
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var AdaptiveInterruptionDetector_exports = {};
-__export(AdaptiveInterruptionDetector_exports, {
-  AdaptiveInterruptionDetector: () => AdaptiveInterruptionDetector
-});
-module.exports = __toCommonJS(AdaptiveInterruptionDetector_exports);
-var import_events = __toESM(require("events"), 1);
-var import_web = require("stream/web");
-var import_InterruptionStream = require("./InterruptionStream.cjs");
-var import_defaults = require("./defaults.cjs");
-var import_interruption = require("./interruption.cjs");
-class AdaptiveInterruptionDetector extends import_events.default {
-  options;
-  label;
-  streams;
-  // TODO: Union of InterruptionHttpStream | InterruptionWebSocketStream
-  constructor(options = {}) {
-    super();
-    const {
-      maxAudioDuration,
-      baseUrl,
-      apiKey,
-      apiSecret,
-      useProxy: useProxyArg,
-      audioPrefixDuration,
-      threshold,
-      detectionInterval,
-      inferenceTimeout,
-      minInterruptionDuration
-    } = { ...import_defaults.interruptionOptionDefaults, ...options };
-    if (maxAudioDuration > 3) {
-      throw new Error("maxAudioDuration must be less than or equal to 3.0 seconds");
-    }
-    const lkBaseUrl = baseUrl ?? process.env.LIVEKIT_REMOTE_EOT_URL ?? import_defaults.DEFAULT_BASE_URL;
-    let lkApiKey = apiKey ?? "";
-    let lkApiSecret = apiSecret ?? "";
-    let useProxy;
-    if (lkBaseUrl === import_defaults.DEFAULT_BASE_URL) {
-      lkApiKey = apiKey ?? process.env.LIVEKIT_INFERENCE_API_KEY ?? process.env.LIVEKIT_API_KEY ?? "";
-      if (!lkApiKey) {
-        throw new Error(
-          "apiKey is required, either as argument or set LIVEKIT_API_KEY environmental variable"
-        );
-      }
-      lkApiSecret = apiSecret ?? process.env.LIVEKIT_INFERENCE_API_SECRET ?? process.env.LIVEKIT_API_SECRET ?? "";
-      if (!lkApiSecret) {
-        throw new Error(
-          "apiSecret is required, either as argument or set LIVEKIT_API_SECRET environmental variable"
-        );
-      }
-      useProxy = true;
-    } else {
-      useProxy = useProxyArg ?? false;
-    }
-    this.options = {
-      sampleRate: import_defaults.SAMPLE_RATE,
-      threshold,
-      minFrames: Math.ceil(minInterruptionDuration * import_defaults.FRAMES_PER_SECOND),
-      maxAudioDuration,
-      audioPrefixDuration,
-      detectionInterval,
-      inferenceTimeout,
-      baseUrl: lkBaseUrl,
-      apiKey: lkApiKey,
-      apiSecret: lkApiSecret,
-      useProxy,
-      minInterruptionDuration
-    };
-    this.label = `${this.constructor.name}`;
-    this.streams = /* @__PURE__ */ new WeakSet();
-    console.info("adaptive interruption detector initialized", {
-      baseUrl: this.options.baseUrl,
-      detectionInterval: this.options.detectionInterval,
-      audioPrefixDuration: this.options.audioPrefixDuration,
-      maxAudioDuration: this.options.maxAudioDuration,
-      minFrames: this.options.minFrames,
-      threshold: this.options.threshold,
-      inferenceTimeout: this.options.inferenceTimeout,
-      useProxy: this.options.useProxy
-    });
-  }
-  /**
-   * Creates a new InterruptionStreamBase for internal use.
-   * The stream can receive audio frames and sentinels via pushFrame().
-   * Use this when you need direct access to the stream for pushing frames.
-   */
-  createStream() {
-    const stream = new import_InterruptionStream.InterruptionStreamBase(this, {});
-    this.streams.add(stream);
-    return stream;
-  }
-  /**
-   * Creates a new interruption stream and returns a ReadableStream of InterruptionEvents.
-   * This is a convenience method for consuming interruption events without needing
-   * to manage the underlying stream directly.
-   */
-  stream() {
-    const httpStream = this.createStream();
-    const transformer = new import_web.TransformStream({
-      transform: (chunk, controller) => {
-        if (chunk.type === import_interruption.InterruptionEventType.INTERRUPTION) {
-          this.emit("interruptionDetected");
-        } else if (chunk.type === import_interruption.InterruptionEventType.OVERLAP_SPEECH_ENDED) {
-          this.emit("overlapSpeechDetected");
-        }
-        controller.enqueue(chunk);
-      }
-    });
-    const stream = httpStream.stream.pipeThrough(transformer);
-    return stream;
-  }
-  updateOptions(options) {
-    if (options.threshold !== void 0) {
-      this.options.threshold = options.threshold;
-    }
-    if (options.minInterruptionDuration !== void 0) {
-      this.options.minFrames = Math.ceil(options.minInterruptionDuration * import_defaults.FRAMES_PER_SECOND);
-    }
-  }
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  AdaptiveInterruptionDetector
-});
-//# sourceMappingURL=AdaptiveInterruptionDetector.cjs.map

package/dist/inference/interruption/AdaptiveInterruptionDetector.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../src/inference/interruption/AdaptiveInterruptionDetector.ts"],"sourcesContent":["import type { TypedEventEmitter } from '@livekit/typed-emitter';\nimport EventEmitter from 'events';\nimport { type ReadableStream, TransformStream } from 'stream/web';\nimport { InterruptionStreamBase } from './InterruptionStream.js';\nimport {\n  DEFAULT_BASE_URL,\n  FRAMES_PER_SECOND,\n  SAMPLE_RATE,\n  interruptionOptionDefaults,\n} from './defaults.js';\nimport {\n  type InterruptionDetectionError,\n  type InterruptionEvent,\n  InterruptionEventType,\n} from './interruption.js';\n\ntype InterruptionCallbacks = {\n  interruptionDetected: () => void;\n  overlapSpeechDetected: () => void;\n  error: (error: InterruptionDetectionError) => void;\n};\n\nexport interface InterruptionOptions {\n  sampleRate: number;\n  threshold: number;\n  minFrames: number;\n  maxAudioDuration: number;\n  audioPrefixDuration: number;\n  detectionInterval: number;\n  inferenceTimeout: number;\n  minInterruptionDuration: number;\n  baseUrl: string;\n  apiKey: string;\n  apiSecret: string;\n  useProxy: boolean;\n}\n\nexport type AdaptiveInterruptionDetectorOptions = Partial<InterruptionOptions>;\n\nexport class AdaptiveInterruptionDetector extends (EventEmitter as new () => TypedEventEmitter<InterruptionCallbacks>) {\n  options: InterruptionOptions;\n  private label: string;\n  private streams: WeakSet<object>; // TODO: Union of InterruptionHttpStream | InterruptionWebSocketStream\n\n  constructor(options: AdaptiveInterruptionDetectorOptions = {}) {\n    super();\n\n    const {\n      maxAudioDuration,\n      baseUrl,\n      apiKey,\n      apiSecret,\n      useProxy: useProxyArg,\n      audioPrefixDuration,\n      threshold,\n      detectionInterval,\n      inferenceTimeout,\n      minInterruptionDuration,\n    } = { ...interruptionOptionDefaults, ...options };\n\n    if (maxAudioDuration > 3.0) {\n      throw new Error('maxAudioDuration must be less than or equal to 3.0 seconds');\n    }\n\n    const lkBaseUrl = baseUrl ?? process.env.LIVEKIT_REMOTE_EOT_URL ?? DEFAULT_BASE_URL;\n    let lkApiKey = apiKey ?? '';\n    let lkApiSecret = apiSecret ?? '';\n    let useProxy: boolean;\n\n    // use LiveKit credentials if using the default base URL (inference)\n    if (lkBaseUrl === DEFAULT_BASE_URL) {\n      lkApiKey =\n        apiKey ?? process.env.LIVEKIT_INFERENCE_API_KEY ?? process.env.LIVEKIT_API_KEY ?? '';\n      if (!lkApiKey) {\n        throw new Error(\n          'apiKey is required, either as argument or set LIVEKIT_API_KEY environmental variable',\n        );\n      }\n\n      lkApiSecret =\n        apiSecret ??\n        process.env.LIVEKIT_INFERENCE_API_SECRET ??\n        process.env.LIVEKIT_API_SECRET ??\n        '';\n      if (!lkApiSecret) {\n        throw new Error(\n          'apiSecret is required, either as argument or set LIVEKIT_API_SECRET environmental variable',\n        );\n      }\n\n      useProxy = true;\n    } else {\n      useProxy = useProxyArg ?? false;\n    }\n\n    this.options = {\n      sampleRate: SAMPLE_RATE,\n      threshold,\n      minFrames: Math.ceil(minInterruptionDuration * FRAMES_PER_SECOND),\n      maxAudioDuration,\n      audioPrefixDuration,\n      detectionInterval,\n      inferenceTimeout,\n      baseUrl: lkBaseUrl,\n      apiKey: lkApiKey,\n      apiSecret: lkApiSecret,\n      useProxy,\n      minInterruptionDuration,\n    };\n\n    this.label = `${this.constructor.name}`;\n    this.streams = new WeakSet();\n\n    console.info('adaptive interruption detector initialized', {\n      baseUrl: this.options.baseUrl,\n      detectionInterval: this.options.detectionInterval,\n      audioPrefixDuration: this.options.audioPrefixDuration,\n      maxAudioDuration: this.options.maxAudioDuration,\n      minFrames: this.options.minFrames,\n      threshold: this.options.threshold,\n      inferenceTimeout: this.options.inferenceTimeout,\n      useProxy: this.options.useProxy,\n    });\n  }\n\n  /**\n   * Creates a new InterruptionStreamBase for internal use.\n   * The stream can receive audio frames and sentinels via pushFrame().\n   * Use this when you need direct access to the stream for pushing frames.\n   */\n  createStream(): InterruptionStreamBase {\n    const stream = new InterruptionStreamBase(this, {});\n    this.streams.add(stream);\n    return stream;\n  }\n\n  /**\n   * Creates a new interruption stream and returns a ReadableStream of InterruptionEvents.\n   * This is a convenience method for consuming interruption events without needing\n   * to manage the underlying stream directly.\n   */\n  stream(): ReadableStream<InterruptionEvent> {\n    const httpStream = this.createStream();\n    const transformer = new TransformStream<InterruptionEvent, InterruptionEvent>({\n      transform: (chunk, controller) => {\n        if (chunk.type === InterruptionEventType.INTERRUPTION) {\n          this.emit('interruptionDetected'); // TODO payload\n        } else if (chunk.type === InterruptionEventType.OVERLAP_SPEECH_ENDED) {\n          this.emit('overlapSpeechDetected'); // TODO payload\n        }\n        controller.enqueue(chunk);\n      },\n    });\n    const stream = httpStream.stream.pipeThrough(transformer);\n    return stream;\n  }\n\n  updateOptions(options: { threshold?: number; minInterruptionDuration?: number }): void {\n    if (options.threshold !== undefined) {\n      this.options.threshold = options.threshold;\n    }\n    if (options.minInterruptionDuration !== undefined) {\n      this.options.minFrames = Math.ceil(options.minInterruptionDuration * FRAMES_PER_SECOND);\n    }\n  }\n}\n"],"mappings":"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","names":["EventEmitter"]}

package/dist/inference/interruption/AdaptiveInterruptionDetector.d.cts

@@ -1,50 +0,0 @@
-/// <reference types="node" resolution-mode="require"/>
-import type { TypedEventEmitter } from '@livekit/typed-emitter';
-import { type ReadableStream } from 'stream/web';
-import { InterruptionStreamBase } from './InterruptionStream.js';
-import { type InterruptionDetectionError, type InterruptionEvent } from './interruption.js';
-type InterruptionCallbacks = {
-    interruptionDetected: () => void;
-    overlapSpeechDetected: () => void;
-    error: (error: InterruptionDetectionError) => void;
-};
-export interface InterruptionOptions {
-    sampleRate: number;
-    threshold: number;
-    minFrames: number;
-    maxAudioDuration: number;
-    audioPrefixDuration: number;
-    detectionInterval: number;
-    inferenceTimeout: number;
-    minInterruptionDuration: number;
-    baseUrl: string;
-    apiKey: string;
-    apiSecret: string;
-    useProxy: boolean;
-}
-export type AdaptiveInterruptionDetectorOptions = Partial<InterruptionOptions>;
-declare const AdaptiveInterruptionDetector_base: new () => TypedEventEmitter<InterruptionCallbacks>;
-export declare class AdaptiveInterruptionDetector extends AdaptiveInterruptionDetector_base {
-    options: InterruptionOptions;
-    private label;
-    private streams;
-    constructor(options?: AdaptiveInterruptionDetectorOptions);
-    /**
-     * Creates a new InterruptionStreamBase for internal use.
-     * The stream can receive audio frames and sentinels via pushFrame().
-     * Use this when you need direct access to the stream for pushing frames.
-     */
-    createStream(): InterruptionStreamBase;
-    /**
-     * Creates a new interruption stream and returns a ReadableStream of InterruptionEvents.
-     * This is a convenience method for consuming interruption events without needing
-     * to manage the underlying stream directly.
-     */
-    stream(): ReadableStream<InterruptionEvent>;
-    updateOptions(options: {
-        threshold?: number;
-        minInterruptionDuration?: number;
-    }): void;
-}
-export {};
-//# sourceMappingURL=AdaptiveInterruptionDetector.d.ts.map

package/dist/inference/interruption/AdaptiveInterruptionDetector.d.ts

@@ -1,50 +0,0 @@
-/// <reference types="node" resolution-mode="require"/>
-import type { TypedEventEmitter } from '@livekit/typed-emitter';
-import { type ReadableStream } from 'stream/web';
-import { InterruptionStreamBase } from './InterruptionStream.js';
-import { type InterruptionDetectionError, type InterruptionEvent } from './interruption.js';
-type InterruptionCallbacks = {
-    interruptionDetected: () => void;
-    overlapSpeechDetected: () => void;
-    error: (error: InterruptionDetectionError) => void;
-};
-export interface InterruptionOptions {
-    sampleRate: number;
-    threshold: number;
-    minFrames: number;
-    maxAudioDuration: number;
-    audioPrefixDuration: number;
-    detectionInterval: number;
-    inferenceTimeout: number;
-    minInterruptionDuration: number;
-    baseUrl: string;
-    apiKey: string;
-    apiSecret: string;
-    useProxy: boolean;
-}
-export type AdaptiveInterruptionDetectorOptions = Partial<InterruptionOptions>;
-declare const AdaptiveInterruptionDetector_base: new () => TypedEventEmitter<InterruptionCallbacks>;
-export declare class AdaptiveInterruptionDetector extends AdaptiveInterruptionDetector_base {
-    options: InterruptionOptions;
-    private label;
-    private streams;
-    constructor(options?: AdaptiveInterruptionDetectorOptions);
-    /**
-     * Creates a new InterruptionStreamBase for internal use.
-     * The stream can receive audio frames and sentinels via pushFrame().
-     * Use this when you need direct access to the stream for pushing frames.
-     */
-    createStream(): InterruptionStreamBase;
-    /**
-     * Creates a new interruption stream and returns a ReadableStream of InterruptionEvents.
-     * This is a convenience method for consuming interruption events without needing
-     * to manage the underlying stream directly.
-     */
-    stream(): ReadableStream<InterruptionEvent>;
-    updateOptions(options: {
-        threshold?: number;
-        minInterruptionDuration?: number;
-    }): void;
-}
-export {};
-//# sourceMappingURL=AdaptiveInterruptionDetector.d.ts.map

package/dist/inference/interruption/AdaptiveInterruptionDetector.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"AdaptiveInterruptionDetector.d.ts","sourceRoot":"","sources":["../../../src/inference/interruption/AdaptiveInterruptionDetector.ts"],"names":[],"mappings":";AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,OAAO,EAAE,KAAK,cAAc,EAAmB,MAAM,YAAY,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAOjE,OAAO,EACL,KAAK,0BAA0B,EAC/B,KAAK,iBAAiB,EAEvB,MAAM,mBAAmB,CAAC;AAE3B,KAAK,qBAAqB,GAAG;IAC3B,oBAAoB,EAAE,MAAM,IAAI,CAAC;IACjC,qBAAqB,EAAE,MAAM,IAAI,CAAC;IAClC,KAAK,EAAE,CAAC,KAAK,EAAE,0BAA0B,KAAK,IAAI,CAAC;CACpD,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,uBAAuB,EAAE,MAAM,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,MAAM,mCAAmC,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;2DAEF,kBAAkB,qBAAqB,CAAC;AAArH,qBAAa,4BAA6B,SAAQ,iCAAoE;IACpH,OAAO,EAAE,mBAAmB,CAAC;IAC7B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,OAAO,CAAkB;gBAErB,OAAO,GAAE,mCAAwC;IAiF7D;;;;OAIG;IACH,YAAY,IAAI,sBAAsB;IAMtC;;;;OAIG;IACH,MAAM,IAAI,cAAc,CAAC,iBAAiB,CAAC;IAgB3C,aAAa,CAAC,OAAO,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,uBAAuB,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;CAQvF"}

package/dist/inference/interruption/AdaptiveInterruptionDetector.js

@@ -1,125 +0,0 @@
-import EventEmitter from "events";
-import { TransformStream } from "stream/web";
-import { InterruptionStreamBase } from "./InterruptionStream.js";
-import {
-  DEFAULT_BASE_URL,
-  FRAMES_PER_SECOND,
-  SAMPLE_RATE,
-  interruptionOptionDefaults
-} from "./defaults.js";
-import {
-  InterruptionEventType
-} from "./interruption.js";
-class AdaptiveInterruptionDetector extends EventEmitter {
-  options;
-  label;
-  streams;
-  // TODO: Union of InterruptionHttpStream | InterruptionWebSocketStream
-  constructor(options = {}) {
-    super();
-    const {
-      maxAudioDuration,
-      baseUrl,
-      apiKey,
-      apiSecret,
-      useProxy: useProxyArg,
-      audioPrefixDuration,
-      threshold,
-      detectionInterval,
-      inferenceTimeout,
-      minInterruptionDuration
-    } = { ...interruptionOptionDefaults, ...options };
-    if (maxAudioDuration > 3) {
-      throw new Error("maxAudioDuration must be less than or equal to 3.0 seconds");
-    }
-    const lkBaseUrl = baseUrl ?? process.env.LIVEKIT_REMOTE_EOT_URL ?? DEFAULT_BASE_URL;
-    let lkApiKey = apiKey ?? "";
-    let lkApiSecret = apiSecret ?? "";
-    let useProxy;
-    if (lkBaseUrl === DEFAULT_BASE_URL) {
-      lkApiKey = apiKey ?? process.env.LIVEKIT_INFERENCE_API_KEY ?? process.env.LIVEKIT_API_KEY ?? "";
-      if (!lkApiKey) {
-        throw new Error(
-          "apiKey is required, either as argument or set LIVEKIT_API_KEY environmental variable"
-        );
-      }
-      lkApiSecret = apiSecret ?? process.env.LIVEKIT_INFERENCE_API_SECRET ?? process.env.LIVEKIT_API_SECRET ?? "";
-      if (!lkApiSecret) {
-        throw new Error(
-          "apiSecret is required, either as argument or set LIVEKIT_API_SECRET environmental variable"
-        );
-      }
-      useProxy = true;
-    } else {
-      useProxy = useProxyArg ?? false;
-    }
-    this.options = {
-      sampleRate: SAMPLE_RATE,
-      threshold,
-      minFrames: Math.ceil(minInterruptionDuration * FRAMES_PER_SECOND),
-      maxAudioDuration,
-      audioPrefixDuration,
-      detectionInterval,
-      inferenceTimeout,
-      baseUrl: lkBaseUrl,
-      apiKey: lkApiKey,
-      apiSecret: lkApiSecret,
-      useProxy,
-      minInterruptionDuration
-    };
-    this.label = `${this.constructor.name}`;
-    this.streams = /* @__PURE__ */ new WeakSet();
-    console.info("adaptive interruption detector initialized", {
-      baseUrl: this.options.baseUrl,
-      detectionInterval: this.options.detectionInterval,
-      audioPrefixDuration: this.options.audioPrefixDuration,
-      maxAudioDuration: this.options.maxAudioDuration,
-      minFrames: this.options.minFrames,
-      threshold: this.options.threshold,
-      inferenceTimeout: this.options.inferenceTimeout,
-      useProxy: this.options.useProxy
-    });
-  }
-  /**
-   * Creates a new InterruptionStreamBase for internal use.
-   * The stream can receive audio frames and sentinels via pushFrame().
-   * Use this when you need direct access to the stream for pushing frames.
-   */
-  createStream() {
-    const stream = new InterruptionStreamBase(this, {});
-    this.streams.add(stream);
-    return stream;
-  }
-  /**
-   * Creates a new interruption stream and returns a ReadableStream of InterruptionEvents.
-   * This is a convenience method for consuming interruption events without needing
-   * to manage the underlying stream directly.
-   */
-  stream() {
-    const httpStream = this.createStream();
-    const transformer = new TransformStream({
-      transform: (chunk, controller) => {
-        if (chunk.type === InterruptionEventType.INTERRUPTION) {
-          this.emit("interruptionDetected");
-        } else if (chunk.type === InterruptionEventType.OVERLAP_SPEECH_ENDED) {
-          this.emit("overlapSpeechDetected");
-        }
-        controller.enqueue(chunk);
-      }
-    });
-    const stream = httpStream.stream.pipeThrough(transformer);
-    return stream;
-  }
-  updateOptions(options) {
-    if (options.threshold !== void 0) {
-      this.options.threshold = options.threshold;
-    }
-    if (options.minInterruptionDuration !== void 0) {
-      this.options.minFrames = Math.ceil(options.minInterruptionDuration * FRAMES_PER_SECOND);
-    }
-  }
-}
-export {
-  AdaptiveInterruptionDetector
-};
-//# sourceMappingURL=AdaptiveInterruptionDetector.js.map

package/dist/inference/interruption/AdaptiveInterruptionDetector.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../src/inference/interruption/AdaptiveInterruptionDetector.ts"],"sourcesContent":["import type { TypedEventEmitter } from '@livekit/typed-emitter';\nimport EventEmitter from 'events';\nimport { type ReadableStream, TransformStream } from 'stream/web';\nimport { InterruptionStreamBase } from './InterruptionStream.js';\nimport {\n  DEFAULT_BASE_URL,\n  FRAMES_PER_SECOND,\n  SAMPLE_RATE,\n  interruptionOptionDefaults,\n} from './defaults.js';\nimport {\n  type InterruptionDetectionError,\n  type InterruptionEvent,\n  InterruptionEventType,\n} from './interruption.js';\n\ntype InterruptionCallbacks = {\n  interruptionDetected: () => void;\n  overlapSpeechDetected: () => void;\n  error: (error: InterruptionDetectionError) => void;\n};\n\nexport interface InterruptionOptions {\n  sampleRate: number;\n  threshold: number;\n  minFrames: number;\n  maxAudioDuration: number;\n  audioPrefixDuration: number;\n  detectionInterval: number;\n  inferenceTimeout: number;\n  minInterruptionDuration: number;\n  baseUrl: string;\n  apiKey: string;\n  apiSecret: string;\n  useProxy: boolean;\n}\n\nexport type AdaptiveInterruptionDetectorOptions = Partial<InterruptionOptions>;\n\nexport class AdaptiveInterruptionDetector extends (EventEmitter as new () => TypedEventEmitter<InterruptionCallbacks>) {\n  options: InterruptionOptions;\n  private label: string;\n  private streams: WeakSet<object>; // TODO: Union of InterruptionHttpStream | InterruptionWebSocketStream\n\n  constructor(options: AdaptiveInterruptionDetectorOptions = {}) {\n    super();\n\n    const {\n      maxAudioDuration,\n      baseUrl,\n      apiKey,\n      apiSecret,\n      useProxy: useProxyArg,\n      audioPrefixDuration,\n      threshold,\n      detectionInterval,\n      inferenceTimeout,\n      minInterruptionDuration,\n    } = { ...interruptionOptionDefaults, ...options };\n\n    if (maxAudioDuration > 3.0) {\n      throw new Error('maxAudioDuration must be less than or equal to 3.0 seconds');\n    }\n\n    const lkBaseUrl = baseUrl ?? process.env.LIVEKIT_REMOTE_EOT_URL ?? DEFAULT_BASE_URL;\n    let lkApiKey = apiKey ?? '';\n    let lkApiSecret = apiSecret ?? '';\n    let useProxy: boolean;\n\n    // use LiveKit credentials if using the default base URL (inference)\n    if (lkBaseUrl === DEFAULT_BASE_URL) {\n      lkApiKey =\n        apiKey ?? process.env.LIVEKIT_INFERENCE_API_KEY ?? process.env.LIVEKIT_API_KEY ?? '';\n      if (!lkApiKey) {\n        throw new Error(\n          'apiKey is required, either as argument or set LIVEKIT_API_KEY environmental variable',\n        );\n      }\n\n      lkApiSecret =\n        apiSecret ??\n        process.env.LIVEKIT_INFERENCE_API_SECRET ??\n        process.env.LIVEKIT_API_SECRET ??\n        '';\n      if (!lkApiSecret) {\n        throw new Error(\n          'apiSecret is required, either as argument or set LIVEKIT_API_SECRET environmental variable',\n        );\n      }\n\n      useProxy = true;\n    } else {\n      useProxy = useProxyArg ?? false;\n    }\n\n    this.options = {\n      sampleRate: SAMPLE_RATE,\n      threshold,\n      minFrames: Math.ceil(minInterruptionDuration * FRAMES_PER_SECOND),\n      maxAudioDuration,\n      audioPrefixDuration,\n      detectionInterval,\n      inferenceTimeout,\n      baseUrl: lkBaseUrl,\n      apiKey: lkApiKey,\n      apiSecret: lkApiSecret,\n      useProxy,\n      minInterruptionDuration,\n    };\n\n    this.label = `${this.constructor.name}`;\n    this.streams = new WeakSet();\n\n    console.info('adaptive interruption detector initialized', {\n      baseUrl: this.options.baseUrl,\n      detectionInterval: this.options.detectionInterval,\n      audioPrefixDuration: this.options.audioPrefixDuration,\n      maxAudioDuration: this.options.maxAudioDuration,\n      minFrames: this.options.minFrames,\n      threshold: this.options.threshold,\n      inferenceTimeout: this.options.inferenceTimeout,\n      useProxy: this.options.useProxy,\n    });\n  }\n\n  /**\n   * Creates a new InterruptionStreamBase for internal use.\n   * The stream can receive audio frames and sentinels via pushFrame().\n   * Use this when you need direct access to the stream for pushing frames.\n   */\n  createStream(): InterruptionStreamBase {\n    const stream = new InterruptionStreamBase(this, {});\n    this.streams.add(stream);\n    return stream;\n  }\n\n  /**\n   * Creates a new interruption stream and returns a ReadableStream of InterruptionEvents.\n   * This is a convenience method for consuming interruption events without needing\n   * to manage the underlying stream directly.\n   */\n  stream(): ReadableStream<InterruptionEvent> {\n    const httpStream = this.createStream();\n    const transformer = new TransformStream<InterruptionEvent, InterruptionEvent>({\n      transform: (chunk, controller) => {\n        if (chunk.type === InterruptionEventType.INTERRUPTION) {\n          this.emit('interruptionDetected'); // TODO payload\n        } else if (chunk.type === InterruptionEventType.OVERLAP_SPEECH_ENDED) {\n          this.emit('overlapSpeechDetected'); // TODO payload\n        }\n        controller.enqueue(chunk);\n      },\n    });\n    const stream = httpStream.stream.pipeThrough(transformer);\n    return stream;\n  }\n\n  updateOptions(options: { threshold?: number; minInterruptionDuration?: number }): void {\n    if (options.threshold !== undefined) {\n      this.options.threshold = options.threshold;\n    }\n    if (options.minInterruptionDuration !== undefined) {\n      this.options.minFrames = Math.ceil(options.minInterruptionDuration * FRAMES_PER_SECOND);\n    }\n  }\n}\n"],"mappings":"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","names":[]}