@livekit/agents 0.0.0-20260120144724

package/dist/audio.cjs

@@ -0,0 +1,170 @@
+"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 audio_exports = {};
+__export(audio_exports, {
+  AudioByteStream: () => AudioByteStream,
+  audioFramesFromFile: () => audioFramesFromFile,
+  calculateAudioDurationSeconds: () => calculateAudioDurationSeconds,
+  loopAudioFramesFromFile: () => loopAudioFramesFromFile
+});
+module.exports = __toCommonJS(audio_exports);
+var import_ffmpeg = __toESM(require("@ffmpeg-installer/ffmpeg"), 1);
+var import_rtc_node = require("@livekit/rtc-node");
+var import_fluent_ffmpeg = __toESM(require("fluent-ffmpeg"), 1);
+var import_log = require("./log.cjs");
+var import_stream_channel = require("./stream/stream_channel.cjs");
+import_fluent_ffmpeg.default.setFfmpegPath(import_ffmpeg.default.path);
+function calculateAudioDurationSeconds(frame) {
+  return Array.isArray(frame) ? frame.reduce((sum, a) => sum + a.samplesPerChannel / a.sampleRate, 0) : frame.samplesPerChannel / frame.sampleRate;
+}
+class AudioByteStream {
+  #sampleRate;
+  #numChannels;
+  #bytesPerFrame;
+  #buf;
+  #logger = (0, import_log.log)();
+  constructor(sampleRate, numChannels, samplesPerChannel = null) {
+    this.#sampleRate = sampleRate;
+    this.#numChannels = numChannels;
+    if (samplesPerChannel === null) {
+      samplesPerChannel = Math.floor(sampleRate / 10);
+    }
+    this.#bytesPerFrame = numChannels * samplesPerChannel * 2;
+    this.#buf = new Int8Array();
+  }
+  write(data) {
+    this.#buf = new Int8Array([...this.#buf, ...new Int8Array(data)]);
+    const frames = [];
+    while (this.#buf.length >= this.#bytesPerFrame) {
+      const frameData = this.#buf.slice(0, this.#bytesPerFrame);
+      this.#buf = this.#buf.slice(this.#bytesPerFrame);
+      frames.push(
+        new import_rtc_node.AudioFrame(
+          new Int16Array(frameData.buffer),
+          this.#sampleRate,
+          this.#numChannels,
+          frameData.length / 2
+        )
+      );
+    }
+    return frames;
+  }
+  flush() {
+    if (this.#buf.length % (2 * this.#numChannels) !== 0) {
+      this.#logger.warn("AudioByteStream: incomplete frame during flush, dropping");
+      return [];
+    }
+    const frames = [
+      new import_rtc_node.AudioFrame(
+        new Int16Array(this.#buf.buffer),
+        this.#sampleRate,
+        this.#numChannels,
+        this.#buf.length / 2
+      )
+    ];
+    this.#buf = new Int8Array();
+    return frames;
+  }
+}
+function audioFramesFromFile(filePath, options = {}) {
+  var _a;
+  const sampleRate = options.sampleRate ?? 48e3;
+  const numChannels = options.numChannels ?? 1;
+  const audioStream = new AudioByteStream(sampleRate, numChannels);
+  const channel = (0, import_stream_channel.createStreamChannel)();
+  const logger = (0, import_log.log)();
+  const command = (0, import_fluent_ffmpeg.default)(filePath).inputOptions([
+    "-probesize",
+    "32",
+    "-analyzeduration",
+    "0",
+    "-fflags",
+    "+nobuffer+flush_packets",
+    "-flags",
+    "low_delay"
+  ]).format("s16le").audioChannels(numChannels).audioFrequency(sampleRate);
+  let commandRunning = true;
+  const onClose = () => {
+    logger.debug("Audio file playback aborted");
+    channel.close();
+    if (commandRunning) {
+      commandRunning = false;
+      command.kill("SIGKILL");
+    }
+  };
+  const outputStream = command.pipe();
+  (_a = options.abortSignal) == null ? void 0 : _a.addEventListener("abort", onClose, { once: true });
+  outputStream.on("data", (chunk) => {
+    const arrayBuffer = chunk.buffer.slice(
+      chunk.byteOffset,
+      chunk.byteOffset + chunk.byteLength
+    );
+    const frames = audioStream.write(arrayBuffer);
+    for (const frame of frames) {
+      channel.write(frame);
+    }
+  });
+  outputStream.on("end", () => {
+    const frames = audioStream.flush();
+    for (const frame of frames) {
+      channel.write(frame);
+    }
+    commandRunning = false;
+    channel.close();
+  });
+  outputStream.on("error", (err) => {
+    logger.error(err);
+    commandRunning = false;
+    onClose();
+  });
+  return channel.stream();
+}
+async function* loopAudioFramesFromFile(filePath, options = {}) {
+  var _a;
+  const frames = [];
+  const logger = (0, import_log.log)();
+  for await (const frame of audioFramesFromFile(filePath, options)) {
+    frames.push(frame);
+    yield frame;
+  }
+  while (!((_a = options.abortSignal) == null ? void 0 : _a.aborted)) {
+    for (const frame of frames) {
+      yield frame;
+    }
+  }
+  logger.debug("Audio file playback loop finished");
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AudioByteStream,
+  audioFramesFromFile,
+  calculateAudioDurationSeconds,
+  loopAudioFramesFromFile
+});
+//# sourceMappingURL=audio.cjs.map

package/dist/audio.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/audio.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport ffmpegInstaller from '@ffmpeg-installer/ffmpeg';\nimport { AudioFrame } from '@livekit/rtc-node';\nimport ffmpeg from 'fluent-ffmpeg';\nimport type { ReadableStream } from 'node:stream/web';\nimport { log } from './log.js';\nimport { createStreamChannel } from './stream/stream_channel.js';\nimport type { AudioBuffer } from './utils.js';\n\nffmpeg.setFfmpegPath(ffmpegInstaller.path);\n\nexport interface AudioDecodeOptions {\n  sampleRate?: number;\n  numChannels?: number;\n  /**\n   * Audio format hint (e.g., 'mp3', 'ogg', 'wav', 'opus')\n   * If not provided, FFmpeg will auto-detect\n   */\n  format?: string;\n  abortSignal?: AbortSignal;\n}\n\nexport function calculateAudioDurationSeconds(frame: AudioBuffer) {\n  // TODO(AJS-102): use frame.durationMs once available in rtc-node\n  return Array.isArray(frame)\n    ? frame.reduce((sum, a) => sum + a.samplesPerChannel / a.sampleRate, 0)\n    : frame.samplesPerChannel / frame.sampleRate;\n}\n\n/** AudioByteStream translates between LiveKit AudioFrame packets and raw byte data. */\nexport class AudioByteStream {\n  #sampleRate: number;\n  #numChannels: number;\n  #bytesPerFrame: number;\n  #buf: Int8Array;\n  #logger = log();\n\n  constructor(sampleRate: number, numChannels: number, samplesPerChannel: number | null = null) {\n    this.#sampleRate = sampleRate;\n    this.#numChannels = numChannels;\n\n    if (samplesPerChannel === null) {\n      samplesPerChannel = Math.floor(sampleRate / 10); // 100ms by default\n    }\n\n    this.#bytesPerFrame = numChannels * samplesPerChannel * 2; // 2 bytes per sample (Int16)\n    this.#buf = new Int8Array();\n  }\n\n  write(data: ArrayBuffer): AudioFrame[] {\n    this.#buf = new Int8Array([...this.#buf, ...new Int8Array(data)]);\n\n    const frames: AudioFrame[] = [];\n    while (this.#buf.length >= this.#bytesPerFrame) {\n      const frameData = this.#buf.slice(0, this.#bytesPerFrame);\n      this.#buf = this.#buf.slice(this.#bytesPerFrame);\n\n      frames.push(\n        new AudioFrame(\n          new Int16Array(frameData.buffer),\n          this.#sampleRate,\n          this.#numChannels,\n          frameData.length / 2,\n        ),\n      );\n    }\n\n    return frames;\n  }\n\n  flush(): AudioFrame[] {\n    if (this.#buf.length % (2 * this.#numChannels) !== 0) {\n      this.#logger.warn('AudioByteStream: incomplete frame during flush, dropping');\n      return [];\n    }\n\n    const frames = [\n      new AudioFrame(\n        new Int16Array(this.#buf.buffer),\n        this.#sampleRate,\n        this.#numChannels,\n        this.#buf.length / 2,\n      ),\n    ];\n\n    this.#buf = new Int8Array(); // Clear buffer after flushing\n    return frames;\n  }\n}\n\n/**\n * Decode an audio file into AudioFrame instances\n *\n * @param filePath - Path to the audio file\n * @param options - Decoding options\n * @returns AsyncGenerator that yields AudioFrame objects\n *\n * @example\n * ```typescript\n * for await (const frame of audioFramesFromFile('audio.ogg', { sampleRate: 48000 })) {\n *   console.log('Frame:', frame.samplesPerChannel, 'samples');\n * }\n * ```\n */\nexport function audioFramesFromFile(\n  filePath: string,\n  options: AudioDecodeOptions = {},\n): ReadableStream<AudioFrame> {\n  const sampleRate = options.sampleRate ?? 48000;\n  const numChannels = options.numChannels ?? 1;\n\n  const audioStream = new AudioByteStream(sampleRate, numChannels);\n  const channel = createStreamChannel<AudioFrame>();\n  const logger = log();\n\n  // TODO (Brian): decode WAV using a custom decoder instead of FFmpeg\n  const command = ffmpeg(filePath)\n    .inputOptions([\n      '-probesize',\n      '32',\n      '-analyzeduration',\n      '0',\n      '-fflags',\n      '+nobuffer+flush_packets',\n      '-flags',\n      'low_delay',\n    ])\n    .format('s16le') // signed 16-bit little-endian PCM to be consistent cross-platform\n    .audioChannels(numChannels)\n    .audioFrequency(sampleRate);\n\n  let commandRunning = true;\n\n  const onClose = () => {\n    logger.debug('Audio file playback aborted');\n\n    channel.close();\n    if (commandRunning) {\n      commandRunning = false;\n      command.kill('SIGKILL');\n    }\n  };\n\n  const outputStream = command.pipe();\n  options.abortSignal?.addEventListener('abort', onClose, { once: true });\n\n  outputStream.on('data', (chunk: Buffer) => {\n    const arrayBuffer = chunk.buffer.slice(\n      chunk.byteOffset,\n      chunk.byteOffset + chunk.byteLength,\n    ) as ArrayBuffer;\n\n    const frames = audioStream.write(arrayBuffer);\n    for (const frame of frames) {\n      channel.write(frame);\n    }\n  });\n\n  outputStream.on('end', () => {\n    const frames = audioStream.flush();\n    for (const frame of frames) {\n      channel.write(frame);\n    }\n    commandRunning = false;\n    channel.close();\n  });\n\n  outputStream.on('error', (err: Error) => {\n    logger.error(err);\n    commandRunning = false;\n    onClose();\n  });\n\n  return channel.stream();\n}\n\n/**\n * Loop audio frames from a file indefinitely\n *\n * @param filePath - Path to the audio file\n * @param options - Decoding options\n * @returns AsyncGenerator that yields AudioFrame objects in an infinite loop\n */\nexport async function* loopAudioFramesFromFile(\n  filePath: string,\n  options: AudioDecodeOptions = {},\n): AsyncGenerator<AudioFrame, void, unknown> {\n  const frames: AudioFrame[] = [];\n  const logger = log();\n\n  for await (const frame of audioFramesFromFile(filePath, options)) {\n    frames.push(frame);\n    yield frame;\n  }\n\n  while (!options.abortSignal?.aborted) {\n    for (const frame of frames) {\n      yield frame;\n    }\n  }\n\n  logger.debug('Audio file playback loop finished');\n}\n"],"mappings":"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","names":["ffmpeg","ffmpegInstaller"]}

package/dist/audio.d.cts

@@ -0,0 +1,46 @@
+/// <reference types="node" resolution-mode="require"/>
+import { AudioFrame } from '@livekit/rtc-node';
+import type { ReadableStream } from 'node:stream/web';
+import type { AudioBuffer } from './utils.js';
+export interface AudioDecodeOptions {
+    sampleRate?: number;
+    numChannels?: number;
+    /**
+     * Audio format hint (e.g., 'mp3', 'ogg', 'wav', 'opus')
+     * If not provided, FFmpeg will auto-detect
+     */
+    format?: string;
+    abortSignal?: AbortSignal;
+}
+export declare function calculateAudioDurationSeconds(frame: AudioBuffer): number;
+/** AudioByteStream translates between LiveKit AudioFrame packets and raw byte data. */
+export declare class AudioByteStream {
+    #private;
+    constructor(sampleRate: number, numChannels: number, samplesPerChannel?: number | null);
+    write(data: ArrayBuffer): AudioFrame[];
+    flush(): AudioFrame[];
+}
+/**
+ * Decode an audio file into AudioFrame instances
+ *
+ * @param filePath - Path to the audio file
+ * @param options - Decoding options
+ * @returns AsyncGenerator that yields AudioFrame objects
+ *
+ * @example
+ * ```typescript
+ * for await (const frame of audioFramesFromFile('audio.ogg', { sampleRate: 48000 })) {
+ *   console.log('Frame:', frame.samplesPerChannel, 'samples');
+ * }
+ * ```
+ */
+export declare function audioFramesFromFile(filePath: string, options?: AudioDecodeOptions): ReadableStream<AudioFrame>;
+/**
+ * Loop audio frames from a file indefinitely
+ *
+ * @param filePath - Path to the audio file
+ * @param options - Decoding options
+ * @returns AsyncGenerator that yields AudioFrame objects in an infinite loop
+ */
+export declare function loopAudioFramesFromFile(filePath: string, options?: AudioDecodeOptions): AsyncGenerator<AudioFrame, void, unknown>;
+//# sourceMappingURL=audio.d.ts.map

package/dist/audio.d.ts

@@ -0,0 +1,46 @@
+/// <reference types="node" resolution-mode="require"/>
+import { AudioFrame } from '@livekit/rtc-node';
+import type { ReadableStream } from 'node:stream/web';
+import type { AudioBuffer } from './utils.js';
+export interface AudioDecodeOptions {
+    sampleRate?: number;
+    numChannels?: number;
+    /**
+     * Audio format hint (e.g., 'mp3', 'ogg', 'wav', 'opus')
+     * If not provided, FFmpeg will auto-detect
+     */
+    format?: string;
+    abortSignal?: AbortSignal;
+}
+export declare function calculateAudioDurationSeconds(frame: AudioBuffer): number;
+/** AudioByteStream translates between LiveKit AudioFrame packets and raw byte data. */
+export declare class AudioByteStream {
+    #private;
+    constructor(sampleRate: number, numChannels: number, samplesPerChannel?: number | null);
+    write(data: ArrayBuffer): AudioFrame[];
+    flush(): AudioFrame[];
+}
+/**
+ * Decode an audio file into AudioFrame instances
+ *
+ * @param filePath - Path to the audio file
+ * @param options - Decoding options
+ * @returns AsyncGenerator that yields AudioFrame objects
+ *
+ * @example
+ * ```typescript
+ * for await (const frame of audioFramesFromFile('audio.ogg', { sampleRate: 48000 })) {
+ *   console.log('Frame:', frame.samplesPerChannel, 'samples');
+ * }
+ * ```
+ */
+export declare function audioFramesFromFile(filePath: string, options?: AudioDecodeOptions): ReadableStream<AudioFrame>;
+/**
+ * Loop audio frames from a file indefinitely
+ *
+ * @param filePath - Path to the audio file
+ * @param options - Decoding options
+ * @returns AsyncGenerator that yields AudioFrame objects in an infinite loop
+ */
+export declare function loopAudioFramesFromFile(filePath: string, options?: AudioDecodeOptions): AsyncGenerator<AudioFrame, void, unknown>;
+//# sourceMappingURL=audio.d.ts.map

package/dist/audio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../src/audio.ts"],"names":[],"mappings":";AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI9C,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,WAAW,UAK/D;AAED,uFAAuF;AACvF,qBAAa,eAAe;;gBAOd,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,iBAAiB,GAAE,MAAM,GAAG,IAAW;IAY5F,KAAK,CAAC,IAAI,EAAE,WAAW,GAAG,UAAU,EAAE;IAqBtC,KAAK,IAAI,UAAU,EAAE;CAkBtB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,kBAAuB,GAC/B,cAAc,CAAC,UAAU,CAAC,CAmE5B;AAED;;;;;;GAMG;AACH,wBAAuB,uBAAuB,CAC5C,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,kBAAuB,GAC/B,cAAc,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,CAgB3C"}

package/dist/audio.js

@@ -0,0 +1,133 @@
+import ffmpegInstaller from "@ffmpeg-installer/ffmpeg";
+import { AudioFrame } from "@livekit/rtc-node";
+import ffmpeg from "fluent-ffmpeg";
+import { log } from "./log.js";
+import { createStreamChannel } from "./stream/stream_channel.js";
+ffmpeg.setFfmpegPath(ffmpegInstaller.path);
+function calculateAudioDurationSeconds(frame) {
+  return Array.isArray(frame) ? frame.reduce((sum, a) => sum + a.samplesPerChannel / a.sampleRate, 0) : frame.samplesPerChannel / frame.sampleRate;
+}
+class AudioByteStream {
+  #sampleRate;
+  #numChannels;
+  #bytesPerFrame;
+  #buf;
+  #logger = log();
+  constructor(sampleRate, numChannels, samplesPerChannel = null) {
+    this.#sampleRate = sampleRate;
+    this.#numChannels = numChannels;
+    if (samplesPerChannel === null) {
+      samplesPerChannel = Math.floor(sampleRate / 10);
+    }
+    this.#bytesPerFrame = numChannels * samplesPerChannel * 2;
+    this.#buf = new Int8Array();
+  }
+  write(data) {
+    this.#buf = new Int8Array([...this.#buf, ...new Int8Array(data)]);
+    const frames = [];
+    while (this.#buf.length >= this.#bytesPerFrame) {
+      const frameData = this.#buf.slice(0, this.#bytesPerFrame);
+      this.#buf = this.#buf.slice(this.#bytesPerFrame);
+      frames.push(
+        new AudioFrame(
+          new Int16Array(frameData.buffer),
+          this.#sampleRate,
+          this.#numChannels,
+          frameData.length / 2
+        )
+      );
+    }
+    return frames;
+  }
+  flush() {
+    if (this.#buf.length % (2 * this.#numChannels) !== 0) {
+      this.#logger.warn("AudioByteStream: incomplete frame during flush, dropping");
+      return [];
+    }
+    const frames = [
+      new AudioFrame(
+        new Int16Array(this.#buf.buffer),
+        this.#sampleRate,
+        this.#numChannels,
+        this.#buf.length / 2
+      )
+    ];
+    this.#buf = new Int8Array();
+    return frames;
+  }
+}
+function audioFramesFromFile(filePath, options = {}) {
+  var _a;
+  const sampleRate = options.sampleRate ?? 48e3;
+  const numChannels = options.numChannels ?? 1;
+  const audioStream = new AudioByteStream(sampleRate, numChannels);
+  const channel = createStreamChannel();
+  const logger = log();
+  const command = ffmpeg(filePath).inputOptions([
+    "-probesize",
+    "32",
+    "-analyzeduration",
+    "0",
+    "-fflags",
+    "+nobuffer+flush_packets",
+    "-flags",
+    "low_delay"
+  ]).format("s16le").audioChannels(numChannels).audioFrequency(sampleRate);
+  let commandRunning = true;
+  const onClose = () => {
+    logger.debug("Audio file playback aborted");
+    channel.close();
+    if (commandRunning) {
+      commandRunning = false;
+      command.kill("SIGKILL");
+    }
+  };
+  const outputStream = command.pipe();
+  (_a = options.abortSignal) == null ? void 0 : _a.addEventListener("abort", onClose, { once: true });
+  outputStream.on("data", (chunk) => {
+    const arrayBuffer = chunk.buffer.slice(
+      chunk.byteOffset,
+      chunk.byteOffset + chunk.byteLength
+    );
+    const frames = audioStream.write(arrayBuffer);
+    for (const frame of frames) {
+      channel.write(frame);
+    }
+  });
+  outputStream.on("end", () => {
+    const frames = audioStream.flush();
+    for (const frame of frames) {
+      channel.write(frame);
+    }
+    commandRunning = false;
+    channel.close();
+  });
+  outputStream.on("error", (err) => {
+    logger.error(err);
+    commandRunning = false;
+    onClose();
+  });
+  return channel.stream();
+}
+async function* loopAudioFramesFromFile(filePath, options = {}) {
+  var _a;
+  const frames = [];
+  const logger = log();
+  for await (const frame of audioFramesFromFile(filePath, options)) {
+    frames.push(frame);
+    yield frame;
+  }
+  while (!((_a = options.abortSignal) == null ? void 0 : _a.aborted)) {
+    for (const frame of frames) {
+      yield frame;
+    }
+  }
+  logger.debug("Audio file playback loop finished");
+}
+export {
+  AudioByteStream,
+  audioFramesFromFile,
+  calculateAudioDurationSeconds,
+  loopAudioFramesFromFile
+};
+//# sourceMappingURL=audio.js.map

package/dist/audio.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/audio.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport ffmpegInstaller from '@ffmpeg-installer/ffmpeg';\nimport { AudioFrame } from '@livekit/rtc-node';\nimport ffmpeg from 'fluent-ffmpeg';\nimport type { ReadableStream } from 'node:stream/web';\nimport { log } from './log.js';\nimport { createStreamChannel } from './stream/stream_channel.js';\nimport type { AudioBuffer } from './utils.js';\n\nffmpeg.setFfmpegPath(ffmpegInstaller.path);\n\nexport interface AudioDecodeOptions {\n  sampleRate?: number;\n  numChannels?: number;\n  /**\n   * Audio format hint (e.g., 'mp3', 'ogg', 'wav', 'opus')\n   * If not provided, FFmpeg will auto-detect\n   */\n  format?: string;\n  abortSignal?: AbortSignal;\n}\n\nexport function calculateAudioDurationSeconds(frame: AudioBuffer) {\n  // TODO(AJS-102): use frame.durationMs once available in rtc-node\n  return Array.isArray(frame)\n    ? frame.reduce((sum, a) => sum + a.samplesPerChannel / a.sampleRate, 0)\n    : frame.samplesPerChannel / frame.sampleRate;\n}\n\n/** AudioByteStream translates between LiveKit AudioFrame packets and raw byte data. */\nexport class AudioByteStream {\n  #sampleRate: number;\n  #numChannels: number;\n  #bytesPerFrame: number;\n  #buf: Int8Array;\n  #logger = log();\n\n  constructor(sampleRate: number, numChannels: number, samplesPerChannel: number | null = null) {\n    this.#sampleRate = sampleRate;\n    this.#numChannels = numChannels;\n\n    if (samplesPerChannel === null) {\n      samplesPerChannel = Math.floor(sampleRate / 10); // 100ms by default\n    }\n\n    this.#bytesPerFrame = numChannels * samplesPerChannel * 2; // 2 bytes per sample (Int16)\n    this.#buf = new Int8Array();\n  }\n\n  write(data: ArrayBuffer): AudioFrame[] {\n    this.#buf = new Int8Array([...this.#buf, ...new Int8Array(data)]);\n\n    const frames: AudioFrame[] = [];\n    while (this.#buf.length >= this.#bytesPerFrame) {\n      const frameData = this.#buf.slice(0, this.#bytesPerFrame);\n      this.#buf = this.#buf.slice(this.#bytesPerFrame);\n\n      frames.push(\n        new AudioFrame(\n          new Int16Array(frameData.buffer),\n          this.#sampleRate,\n          this.#numChannels,\n          frameData.length / 2,\n        ),\n      );\n    }\n\n    return frames;\n  }\n\n  flush(): AudioFrame[] {\n    if (this.#buf.length % (2 * this.#numChannels) !== 0) {\n      this.#logger.warn('AudioByteStream: incomplete frame during flush, dropping');\n      return [];\n    }\n\n    const frames = [\n      new AudioFrame(\n        new Int16Array(this.#buf.buffer),\n        this.#sampleRate,\n        this.#numChannels,\n        this.#buf.length / 2,\n      ),\n    ];\n\n    this.#buf = new Int8Array(); // Clear buffer after flushing\n    return frames;\n  }\n}\n\n/**\n * Decode an audio file into AudioFrame instances\n *\n * @param filePath - Path to the audio file\n * @param options - Decoding options\n * @returns AsyncGenerator that yields AudioFrame objects\n *\n * @example\n * ```typescript\n * for await (const frame of audioFramesFromFile('audio.ogg', { sampleRate: 48000 })) {\n *   console.log('Frame:', frame.samplesPerChannel, 'samples');\n * }\n * ```\n */\nexport function audioFramesFromFile(\n  filePath: string,\n  options: AudioDecodeOptions = {},\n): ReadableStream<AudioFrame> {\n  const sampleRate = options.sampleRate ?? 48000;\n  const numChannels = options.numChannels ?? 1;\n\n  const audioStream = new AudioByteStream(sampleRate, numChannels);\n  const channel = createStreamChannel<AudioFrame>();\n  const logger = log();\n\n  // TODO (Brian): decode WAV using a custom decoder instead of FFmpeg\n  const command = ffmpeg(filePath)\n    .inputOptions([\n      '-probesize',\n      '32',\n      '-analyzeduration',\n      '0',\n      '-fflags',\n      '+nobuffer+flush_packets',\n      '-flags',\n      'low_delay',\n    ])\n    .format('s16le') // signed 16-bit little-endian PCM to be consistent cross-platform\n    .audioChannels(numChannels)\n    .audioFrequency(sampleRate);\n\n  let commandRunning = true;\n\n  const onClose = () => {\n    logger.debug('Audio file playback aborted');\n\n    channel.close();\n    if (commandRunning) {\n      commandRunning = false;\n      command.kill('SIGKILL');\n    }\n  };\n\n  const outputStream = command.pipe();\n  options.abortSignal?.addEventListener('abort', onClose, { once: true });\n\n  outputStream.on('data', (chunk: Buffer) => {\n    const arrayBuffer = chunk.buffer.slice(\n      chunk.byteOffset,\n      chunk.byteOffset + chunk.byteLength,\n    ) as ArrayBuffer;\n\n    const frames = audioStream.write(arrayBuffer);\n    for (const frame of frames) {\n      channel.write(frame);\n    }\n  });\n\n  outputStream.on('end', () => {\n    const frames = audioStream.flush();\n    for (const frame of frames) {\n      channel.write(frame);\n    }\n    commandRunning = false;\n    channel.close();\n  });\n\n  outputStream.on('error', (err: Error) => {\n    logger.error(err);\n    commandRunning = false;\n    onClose();\n  });\n\n  return channel.stream();\n}\n\n/**\n * Loop audio frames from a file indefinitely\n *\n * @param filePath - Path to the audio file\n * @param options - Decoding options\n * @returns AsyncGenerator that yields AudioFrame objects in an infinite loop\n */\nexport async function* loopAudioFramesFromFile(\n  filePath: string,\n  options: AudioDecodeOptions = {},\n): AsyncGenerator<AudioFrame, void, unknown> {\n  const frames: AudioFrame[] = [];\n  const logger = log();\n\n  for await (const frame of audioFramesFromFile(filePath, options)) {\n    frames.push(frame);\n    yield frame;\n  }\n\n  while (!options.abortSignal?.aborted) {\n    for (const frame of frames) {\n      yield frame;\n    }\n  }\n\n  logger.debug('Audio file playback loop finished');\n}\n"],"mappings":"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","names":[]}

package/dist/cli.cjs

@@ -0,0 +1,171 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var cli_exports = {};
+__export(cli_exports, {
+  runApp: () => runApp
+});
+module.exports = __toCommonJS(cli_exports);
+var getImportMetaUrl = () => typeof document === "undefined" ? new URL(`file:${__filename}`).href : document.currentScript && document.currentScript.src || new URL("main.js", document.baseURI).href;
+var importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
+var import_commander = require("commander");
+var import_log = require("./log.cjs");
+var import_plugin = require("./plugin.cjs");
+var import_version = require("./version.cjs");
+var import_worker = require("./worker.cjs");
+const runServer = async (args) => {
+  (0, import_log.initializeLogger)({ pretty: !args.production, level: args.opts.logLevel });
+  const logger = (0, import_log.log)();
+  const { production: _, ...opts } = args.opts;
+  const server = new import_worker.AgentServer(new import_worker.ServerOptions({ production: args.production, ...opts }));
+  if (args.room) {
+    server.event.once("worker_registered", () => {
+      logger.info(`connecting to room ${args.room}`);
+      server.simulateJob(args.room, args.participantIdentity);
+    });
+  }
+  process.once("SIGINT", async () => {
+    logger.debug("SIGINT received in CLI");
+    process.once("SIGINT", () => {
+      console.log("Force exit (Ctrl+C pressed twice)");
+      process.exit(130);
+    });
+    if (args.production) {
+      await server.drain();
+    }
+    await server.close();
+    logger.debug("worker closed due to SIGINT.");
+    process.exit(130);
+  });
+  process.once("SIGTERM", async () => {
+    logger.debug("SIGTERM received in CLI.");
+    if (args.production) {
+      await server.drain();
+    }
+    await server.close();
+    logger.debug("worker closed due to SIGTERM.");
+    process.exit(143);
+  });
+  try {
+    await server.run();
+  } catch {
+    logger.fatal("closing worker due to error.");
+    process.exit(1);
+  }
+};
+const runApp = (opts) => {
+  const program = new import_commander.Command().name("agents").description("LiveKit Agents CLI").version(import_version.version).addOption(
+    new import_commander.Option("--log-level <level>", "Set the logging level").choices(["trace", "debug", "info", "warn", "error", "fatal"]).default("info").env("LOG_LEVEL")
+  ).addOption(
+    new import_commander.Option("--url <string>", "LiveKit server or Cloud project websocket URL").env(
+      "LIVEKIT_URL"
+    )
+  ).addOption(
+    new import_commander.Option("--api-key <string>", "LiveKit server or Cloud project's API key").env(
+      "LIVEKIT_API_KEY"
+    )
+  ).addOption(
+    new import_commander.Option("--api-secret <string>", "LiveKit server or Cloud project's API secret").env(
+      "LIVEKIT_API_SECRET"
+    )
+  ).addOption(
+    new import_commander.Option("--worker-token <string>", "Internal use only").env("LIVEKIT_WORKER_TOKEN").hideHelp()
+  ).action(() => {
+    if (
+      // do not run CLI if origin file is agents/ipc/job_main.js
+      process.argv[1] !== new URL("ipc/job_main.js", importMetaUrl).pathname && process.argv.length < 3
+    ) {
+      program.help();
+    }
+  });
+  program.command("start").description("Start the worker in production mode").action(() => {
+    const options = program.optsWithGlobals();
+    opts.wsURL = options.url || opts.wsURL;
+    opts.apiKey = options.apiKey || opts.apiKey;
+    opts.apiSecret = options.apiSecret || opts.apiSecret;
+    opts.logLevel = options.logLevel || opts.logLevel;
+    opts.workerToken = options.workerToken || opts.workerToken;
+    runServer({
+      opts,
+      production: true,
+      watch: false
+    });
+  });
+  program.command("dev").description("Start the worker in development mode").addOption(
+    new import_commander.Option("--log-level <level>", "Set the logging level").choices(["trace", "debug", "info", "warn", "error", "fatal"]).default("debug").env("LOG_LEVEL")
+  ).action(() => {
+    const options = program.optsWithGlobals();
+    opts.wsURL = options.url || opts.wsURL;
+    opts.apiKey = options.apiKey || opts.apiKey;
+    opts.apiSecret = options.apiSecret || opts.apiSecret;
+    opts.logLevel = options.logLevel || opts.logLevel;
+    opts.workerToken = options.workerToken || opts.workerToken;
+    runServer({
+      opts,
+      production: false,
+      watch: false
+    });
+  });
+  program.command("connect").description("Connect to a specific room").requiredOption("--room <string>", "Room name to connect to").option("--participant-identity <string>", "Identity of user to listen to").addOption(
+    new import_commander.Option("--log-level <level>", "Set the logging level").choices(["trace", "debug", "info", "warn", "error", "fatal"]).default("debug").env("LOG_LEVEL")
+  ).action((...[, command]) => {
+    const options = command.optsWithGlobals();
+    opts.wsURL = options.url || opts.wsURL;
+    opts.apiKey = options.apiKey || opts.apiKey;
+    opts.apiSecret = options.apiSecret || opts.apiSecret;
+    opts.logLevel = options.logLevel || opts.logLevel;
+    opts.workerToken = options.workerToken || opts.workerToken;
+    runServer({
+      opts,
+      production: false,
+      watch: false,
+      room: options.room,
+      participantIdentity: options.participantIdentity
+    });
+  });
+  program.command("download-files").description("Download plugin dependency files").addOption(
+    new import_commander.Option("--log-level <level>", "Set the logging level").choices(["trace", "debug", "info", "warn", "error", "fatal"]).default("debug").env("LOG_LEVEL")
+  ).action(() => {
+    const options = program.optsWithGlobals();
+    (0, import_log.initializeLogger)({ pretty: true, level: options.logLevel });
+    const logger = (0, import_log.log)();
+    const downloadFiles = async () => {
+      for (const plugin of import_plugin.Plugin.registeredPlugins) {
+        logger.info(`Downloading files for ${plugin.title}`);
+        try {
+          await plugin.downloadFiles();
+          logger.info(`Finished downloading files for ${plugin.title}`);
+        } catch (error) {
+          logger.error(`Failed to download files for ${plugin.title}: ${error}`);
+        }
+      }
+    };
+    downloadFiles().catch((error) => {
+      logger.fatal(`Error during file downloads: ${error}`);
+      process.exit(1);
+    }).finally(() => {
+      process.exit(0);
+    });
+  });
+  program.parse();
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  runApp
+});
+//# sourceMappingURL=cli.cjs.map

package/dist/cli.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.ts","../../node_modules/.pnpm/tsup@8.4.0_@microsoft+api-extractor@7.43.7_@types+node@22.15.30__postcss@8.5.6_tsx@4.20.4_typescript@5.4.5/node_modules/tsup/assets/cjs_shims.js"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { Command, Option } from 'commander';\nimport type { EventEmitter } from 'node:events';\nimport { initializeLogger, log } from './log.js';\nimport { Plugin } from './plugin.js';\nimport { version } from './version.js';\nimport { AgentServer, ServerOptions } from './worker.js';\n\ntype CliArgs = {\n  opts: ServerOptions;\n  production: boolean;\n  watch: boolean;\n  event?: EventEmitter;\n  room?: string;\n  participantIdentity?: string;\n};\n\nconst runServer = async (args: CliArgs) => {\n  initializeLogger({ pretty: !args.production, level: args.opts.logLevel });\n  const logger = log();\n\n  // though `production` is defined in ServerOptions, it will always be overridden by CLI.\n  const { production: _, ...opts } = args.opts; // eslint-disable-line @typescript-eslint/no-unused-vars\n  const server = new AgentServer(new ServerOptions({ production: args.production, ...opts }));\n\n  if (args.room) {\n    server.event.once('worker_registered', () => {\n      logger.info(`connecting to room ${args.room}`);\n      server.simulateJob(args.room!, args.participantIdentity);\n    });\n  }\n\n  process.once('SIGINT', async () => {\n    logger.debug('SIGINT received in CLI');\n    // allow C-c C-c for force interrupt\n    process.once('SIGINT', () => {\n      console.log('Force exit (Ctrl+C pressed twice)');\n      process.exit(130); // SIGINT exit code\n    });\n    if (args.production) {\n      await server.drain();\n    }\n    await server.close();\n    logger.debug('worker closed due to SIGINT.');\n    process.exit(130); // SIGINT exit code\n  });\n\n  process.once('SIGTERM', async () => {\n    logger.debug('SIGTERM received in CLI.');\n    if (args.production) {\n      await server.drain();\n    }\n    await server.close();\n    logger.debug('worker closed due to SIGTERM.');\n    process.exit(143); // SIGTERM exit code\n  });\n\n  try {\n    await server.run();\n  } catch {\n    logger.fatal('closing worker due to error.');\n    process.exit(1);\n  }\n};\n\n/**\n * Exposes a CLI for creating a new worker, in development or production mode.\n *\n * @param opts - Options to launch the worker with\n * @example\n * ```\n * if (process.argv[1] === fileURLToPath(import.meta.url)) {\n *   cli.runApp(new ServerOptions({ agent: import.meta.filename }));\n * }\n * ```\n */\nexport const runApp = (opts: ServerOptions) => {\n  const program = new Command()\n    .name('agents')\n    .description('LiveKit Agents CLI')\n    .version(version)\n    .addOption(\n      new Option('--log-level <level>', 'Set the logging level')\n        .choices(['trace', 'debug', 'info', 'warn', 'error', 'fatal'])\n        .default('info')\n        .env('LOG_LEVEL'),\n    )\n    .addOption(\n      new Option('--url <string>', 'LiveKit server or Cloud project websocket URL').env(\n        'LIVEKIT_URL',\n      ),\n    )\n    .addOption(\n      new Option('--api-key <string>', \"LiveKit server or Cloud project's API key\").env(\n        'LIVEKIT_API_KEY',\n      ),\n    )\n    .addOption(\n      new Option('--api-secret <string>', \"LiveKit server or Cloud project's API secret\").env(\n        'LIVEKIT_API_SECRET',\n      ),\n    )\n    .addOption(\n      new Option('--worker-token <string>', 'Internal use only')\n        .env('LIVEKIT_WORKER_TOKEN')\n        .hideHelp(),\n    )\n    .action(() => {\n      if (\n        // do not run CLI if origin file is agents/ipc/job_main.js\n        process.argv[1] !== new URL('ipc/job_main.js', import.meta.url).pathname &&\n        process.argv.length < 3\n      ) {\n        program.help();\n      }\n    });\n\n  program\n    .command('start')\n    .description('Start the worker in production mode')\n    .action(() => {\n      const options = program.optsWithGlobals();\n      opts.wsURL = options.url || opts.wsURL;\n      opts.apiKey = options.apiKey || opts.apiKey;\n      opts.apiSecret = options.apiSecret || opts.apiSecret;\n      opts.logLevel = options.logLevel || opts.logLevel;\n      opts.workerToken = options.workerToken || opts.workerToken;\n      runServer({\n        opts,\n        production: true,\n        watch: false,\n      });\n    });\n\n  program\n    .command('dev')\n    .description('Start the worker in development mode')\n    .addOption(\n      new Option('--log-level <level>', 'Set the logging level')\n        .choices(['trace', 'debug', 'info', 'warn', 'error', 'fatal'])\n        .default('debug')\n        .env('LOG_LEVEL'),\n    )\n    .action(() => {\n      const options = program.optsWithGlobals();\n      opts.wsURL = options.url || opts.wsURL;\n      opts.apiKey = options.apiKey || opts.apiKey;\n      opts.apiSecret = options.apiSecret || opts.apiSecret;\n      opts.logLevel = options.logLevel || opts.logLevel;\n      opts.workerToken = options.workerToken || opts.workerToken;\n      runServer({\n        opts,\n        production: false,\n        watch: false,\n      });\n    });\n\n  program\n    .command('connect')\n    .description('Connect to a specific room')\n    .requiredOption('--room <string>', 'Room name to connect to')\n    .option('--participant-identity <string>', 'Identity of user to listen to')\n    .addOption(\n      new Option('--log-level <level>', 'Set the logging level')\n        .choices(['trace', 'debug', 'info', 'warn', 'error', 'fatal'])\n        .default('debug')\n        .env('LOG_LEVEL'),\n    )\n    .action((...[, command]) => {\n      const options = command.optsWithGlobals();\n      opts.wsURL = options.url || opts.wsURL;\n      opts.apiKey = options.apiKey || opts.apiKey;\n      opts.apiSecret = options.apiSecret || opts.apiSecret;\n      opts.logLevel = options.logLevel || opts.logLevel;\n      opts.workerToken = options.workerToken || opts.workerToken;\n      runServer({\n        opts,\n        production: false,\n        watch: false,\n        room: options.room,\n        participantIdentity: options.participantIdentity,\n      });\n    });\n\n  program\n    .command('download-files')\n    .description('Download plugin dependency files')\n    .addOption(\n      new Option('--log-level <level>', 'Set the logging level')\n        .choices(['trace', 'debug', 'info', 'warn', 'error', 'fatal'])\n        .default('debug')\n        .env('LOG_LEVEL'),\n    )\n    .action(() => {\n      const options = program.optsWithGlobals();\n      initializeLogger({ pretty: true, level: options.logLevel });\n      const logger = log();\n\n      const downloadFiles = async () => {\n        for (const plugin of Plugin.registeredPlugins) {\n          logger.info(`Downloading files for ${plugin.title}`);\n          try {\n            await plugin.downloadFiles();\n            logger.info(`Finished downloading files for ${plugin.title}`);\n          } catch (error) {\n            logger.error(`Failed to download files for ${plugin.title}: ${error}`);\n          }\n        }\n      };\n\n      downloadFiles()\n        .catch((error) => {\n          logger.fatal(`Error during file downloads: ${error}`);\n          process.exit(1);\n        })\n        .finally(() => {\n          process.exit(0);\n        });\n    });\n\n  program.parse();\n};\n","// Shim globals in cjs bundle\n// There's a weird bug that esbuild will always inject importMetaUrl\n// if we export it as `const importMetaUrl = ... __filename ...`\n// But using a function will not cause this issue\n\nconst getImportMetaUrl = () =>\n  typeof document === 'undefined'\n    ? new URL(`file:${__filename}`).href\n    : (document.currentScript && document.currentScript.src) ||\n      new URL('main.js', document.baseURI).href\n\nexport const importMetaUrl = /* @__PURE__ */ getImportMetaUrl()\n"],"mappings":"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","names":[]}

package/dist/cli.d.cts

@@ -0,0 +1,14 @@
+import { ServerOptions } from './worker.js';
+/**
+ * Exposes a CLI for creating a new worker, in development or production mode.
+ *
+ * @param opts - Options to launch the worker with
+ * @example
+ * ```
+ * if (process.argv[1] === fileURLToPath(import.meta.url)) {
+ *   cli.runApp(new ServerOptions({ agent: import.meta.filename }));
+ * }
+ * ```
+ */
+export declare const runApp: (opts: ServerOptions) => void;
+//# sourceMappingURL=cli.d.ts.map