@livekit/agents 0.4.6 → 0.5.0

package/README.md

@@ -0,0 +1,17 @@
+<!--
+SPDX-FileCopyrightText: 2024 LiveKit, Inc.
+
+SPDX-License-Identifier: Apache-2.0
+-->
+# LiveKit Agents for Node.js
+
+The Agents Framework is designed for building realtime, programmable
+participants that run on servers. Use it to create conversational, multi-modal
+voice agents that can see, hear, and understand.
+
+This package contains the main LiveKit Agents SDK. Refer to the
+[documentation](https://docs.livekit.io/agents/overview/) for information on how
+to use it, or browse the [API
+reference](https://docs.livekit.io/agents-js/modules/agents.html). See the
+[repository](https://github.com/livekit/agents-js) for more information about
+the framework as a whole.

package/dist/audio.cjs

@@ -0,0 +1,77 @@
+"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 audio_exports = {};
+__export(audio_exports, {
+  AudioByteStream: () => AudioByteStream
+});
+module.exports = __toCommonJS(audio_exports);
+var import_rtc_node = require("@livekit/rtc-node");
+var import_log = require("./log.cjs");
+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 / 50);
+    }
+    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 [];
+    }
+    return [
+      new import_rtc_node.AudioFrame(
+        new Int16Array(this.#buf.buffer),
+        this.#sampleRate,
+        this.#numChannels,
+        this.#buf.length / 2
+      )
+    ];
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AudioByteStream
+});
+//# 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 { AudioFrame } from '@livekit/rtc-node';\nimport { log } from './log.js';\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 / 50); // 20ms 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    return [\n      new AudioFrame(\n        new Int16Array(this.#buf.buffer),\n        this.#sampleRate,\n        this.#numChannels,\n        this.#buf.length / 2,\n      ),\n    ];\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,sBAA2B;AAC3B,iBAAoB;AAGb,MAAM,gBAAgB;AAAA,EAC3B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,cAAU,gBAAI;AAAA,EAEd,YAAY,YAAoB,aAAqB,oBAAmC,MAAM;AAC5F,SAAK,cAAc;AACnB,SAAK,eAAe;AAEpB,QAAI,sBAAsB,MAAM;AAC9B,0BAAoB,KAAK,MAAM,aAAa,EAAE;AAAA,IAChD;AAEA,SAAK,iBAAiB,cAAc,oBAAoB;AACxD,SAAK,OAAO,IAAI,UAAU;AAAA,EAC5B;AAAA,EAEA,MAAM,MAAiC;AACrC,SAAK,OAAO,IAAI,UAAU,CAAC,GAAG,KAAK,MAAM,GAAG,IAAI,UAAU,IAAI,CAAC,CAAC;AAEhE,UAAM,SAAuB,CAAC;AAC9B,WAAO,KAAK,KAAK,UAAU,KAAK,gBAAgB;AAC9C,YAAM,YAAY,KAAK,KAAK,MAAM,GAAG,KAAK,cAAc;AACxD,WAAK,OAAO,KAAK,KAAK,MAAM,KAAK,cAAc;AAE/C,aAAO;AAAA,QACL,IAAI;AAAA,UACF,IAAI,WAAW,UAAU,MAAM;AAAA,UAC/B,KAAK;AAAA,UACL,KAAK;AAAA,UACL,UAAU,SAAS;AAAA,QACrB;AAAA,MACF;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAAA,EAEA,QAAsB;AACpB,QAAI,KAAK,KAAK,UAAU,IAAI,KAAK,kBAAkB,GAAG;AACpD,WAAK,QAAQ,KAAK,0DAA0D;AAC5E,aAAO,CAAC;AAAA,IACV;AAEA,WAAO;AAAA,MACL,IAAI;AAAA,QACF,IAAI,WAAW,KAAK,KAAK,MAAM;AAAA,QAC/B,KAAK;AAAA,QACL,KAAK;AAAA,QACL,KAAK,KAAK,SAAS;AAAA,MACrB;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/audio.js

@@ -1,42 +1,53 @@
-// SPDX-FileCopyrightText: 2024 LiveKit, Inc.
-//
-// SPDX-License-Identifier: Apache-2.0
-import { AudioFrame } from '@livekit/rtc-node';
-import { log } from './log.js';
-/** AudioByteStream translates between LiveKit AudioFrame packets and raw byte data. */
-export 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 / 50); // 20ms by default
-        }
-        this.#bytesPerFrame = numChannels * samplesPerChannel * 2; // 2 bytes per sample (Int16)
-        this.#buf = new Int8Array();
+import { AudioFrame } from "@livekit/rtc-node";
+import { log } from "./log.js";
+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 / 50);
     }
-    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;
+    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
+        )
+      );
     }
-    flush() {
-        if (this.#buf.length % (2 * this.#numChannels) !== 0) {
-            this.#logger.warn('AudioByteStream: incomplete frame during flush, dropping');
-            return [];
-        }
-        return [
-            new AudioFrame(new Int16Array(this.#buf.buffer), this.#sampleRate, this.#numChannels, this.#buf.length / 2),
-        ];
+    return frames;
+  }
+  flush() {
+    if (this.#buf.length % (2 * this.#numChannels) !== 0) {
+      this.#logger.warn("AudioByteStream: incomplete frame during flush, dropping");
+      return [];
     }
+    return [
+      new AudioFrame(
+        new Int16Array(this.#buf.buffer),
+        this.#sampleRate,
+        this.#numChannels,
+        this.#buf.length / 2
+      )
+    ];
+  }
 }
+export {
+  AudioByteStream
+};
 //# sourceMappingURL=audio.js.map

package/dist/audio.js.map

@@ -1 +1 @@
-{"version":3,"file":"audio.js","sourceRoot":"","sources":["../src/audio.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,EAAE;AACF,sCAAsC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,uFAAuF;AACvF,MAAM,OAAO,eAAe;IAC1B,WAAW,CAAS;IACpB,YAAY,CAAS;IACrB,cAAc,CAAS;IACvB,IAAI,CAAY;IAChB,OAAO,GAAG,GAAG,EAAE,CAAC;IAEhB,YAAY,UAAkB,EAAE,WAAmB,EAAE,oBAAmC,IAAI;QAC1F,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAC9B,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;QAEhC,IAAI,iBAAiB,KAAK,IAAI,EAAE,CAAC;YAC/B,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC,CAAC,kBAAkB;QACrE,CAAC;QAED,IAAI,CAAC,cAAc,GAAG,WAAW,GAAG,iBAAiB,GAAG,CAAC,CAAC,CAAC,6BAA6B;QACxF,IAAI,CAAC,IAAI,GAAG,IAAI,SAAS,EAAE,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,IAAiB;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAElE,MAAM,MAAM,GAAiB,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;YAC1D,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAEjD,MAAM,CAAC,IAAI,CACT,IAAI,UAAU,CACZ,IAAI,UAAU,CAAC,SAAS,CAAC,MAAM,CAAC,EAChC,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,YAAY,EACjB,SAAS,CAAC,MAAM,GAAG,CAAC,CACrB,CACF,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;YACrD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAC;YAC9E,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO;YACL,IAAI,UAAU,CACZ,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAChC,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CACrB;SACF,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"sources":["../src/audio.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { AudioFrame } from '@livekit/rtc-node';\nimport { log } from './log.js';\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 / 50); // 20ms 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    return [\n      new AudioFrame(\n        new Int16Array(this.#buf.buffer),\n        this.#sampleRate,\n        this.#numChannels,\n        this.#buf.length / 2,\n      ),\n    ];\n  }\n}\n"],"mappings":"AAGA,SAAS,kBAAkB;AAC3B,SAAS,WAAW;AAGb,MAAM,gBAAgB;AAAA,EAC3B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,UAAU,IAAI;AAAA,EAEd,YAAY,YAAoB,aAAqB,oBAAmC,MAAM;AAC5F,SAAK,cAAc;AACnB,SAAK,eAAe;AAEpB,QAAI,sBAAsB,MAAM;AAC9B,0BAAoB,KAAK,MAAM,aAAa,EAAE;AAAA,IAChD;AAEA,SAAK,iBAAiB,cAAc,oBAAoB;AACxD,SAAK,OAAO,IAAI,UAAU;AAAA,EAC5B;AAAA,EAEA,MAAM,MAAiC;AACrC,SAAK,OAAO,IAAI,UAAU,CAAC,GAAG,KAAK,MAAM,GAAG,IAAI,UAAU,IAAI,CAAC,CAAC;AAEhE,UAAM,SAAuB,CAAC;AAC9B,WAAO,KAAK,KAAK,UAAU,KAAK,gBAAgB;AAC9C,YAAM,YAAY,KAAK,KAAK,MAAM,GAAG,KAAK,cAAc;AACxD,WAAK,OAAO,KAAK,KAAK,MAAM,KAAK,cAAc;AAE/C,aAAO;AAAA,QACL,IAAI;AAAA,UACF,IAAI,WAAW,UAAU,MAAM;AAAA,UAC/B,KAAK;AAAA,UACL,KAAK;AAAA,UACL,UAAU,SAAS;AAAA,QACrB;AAAA,MACF;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAAA,EAEA,QAAsB;AACpB,QAAI,KAAK,KAAK,UAAU,IAAI,KAAK,kBAAkB,GAAG;AACpD,WAAK,QAAQ,KAAK,0DAA0D;AAC5E,aAAO,CAAC;AAAA,IACV;AAEA,WAAO;AAAA,MACL,IAAI;AAAA,QACF,IAAI,WAAW,KAAK,KAAK,MAAM;AAAA,QAC/B,KAAK;AAAA,QACL,KAAK;AAAA,QACL,KAAK,KAAK,SAAS;AAAA,MACrB;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/cli.cjs

@@ -0,0 +1,131 @@
+"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_version = require("./version.cjs");
+var import_worker = require("./worker.cjs");
+const runWorker = 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 worker = new import_worker.Worker(new import_worker.WorkerOptions({ production: args.production, ...opts }));
+  if (args.room) {
+    worker.event.once("worker_registered", () => {
+      logger.info(`connecting to room ${args.room}`);
+      worker.simulateJob(args.room, args.participantIdentity);
+    });
+  }
+  process.once("SIGINT", async () => {
+    process.once("SIGINT", () => {
+      logger.info("worker closed forcefully");
+      process.exit(130);
+    });
+    if (args.production) {
+      await worker.drain();
+    }
+    await worker.close();
+    logger.info("worker closed");
+    process.exit(130);
+  });
+  try {
+    await worker.run();
+  } catch {
+    logger.fatal("worker failed");
+    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"
+    )
+  ).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;
+    runWorker({
+      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;
+    runWorker({
+      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;
+    runWorker({
+      opts,
+      production: false,
+      watch: false,
+      room: options.room,
+      participantIdentity: options.participantIdentity
+    });
+  });
+  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.3.5_@microsoft+api-extractor@7.43.7_@types+node@22.5.5__postcss@8.4.38_tsx@4.19.2_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 { version } from './version.js';\nimport { Worker, WorkerOptions } from './worker.js';\n\ntype CliArgs = {\n  opts: WorkerOptions;\n  production: boolean;\n  watch: boolean;\n  event?: EventEmitter;\n  room?: string;\n  participantIdentity?: string;\n};\n\nconst runWorker = async (args: CliArgs) => {\n  initializeLogger({ pretty: !args.production, level: args.opts.logLevel });\n  const logger = log();\n\n  // though `production` is defined in WorkerOptions, it will always be overriddden by CLI.\n  const { production: _, ...opts } = args.opts; // eslint-disable-line @typescript-eslint/no-unused-vars\n  const worker = new Worker(new WorkerOptions({ production: args.production, ...opts }));\n\n  if (args.room) {\n    worker.event.once('worker_registered', () => {\n      logger.info(`connecting to room ${args.room}`);\n      worker.simulateJob(args.room!, args.participantIdentity);\n    });\n  }\n\n  process.once('SIGINT', async () => {\n    // allow C-c C-c for force interrupt\n    process.once('SIGINT', () => {\n      logger.info('worker closed forcefully');\n      process.exit(130); // SIGINT exit code\n    });\n    if (args.production) {\n      await worker.drain();\n    }\n    await worker.close();\n    logger.info('worker closed');\n    process.exit(130); // SIGINT exit code\n  });\n\n  try {\n    await worker.run();\n  } catch {\n    logger.fatal('worker failed');\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 WorkerOptions({ agent: import.meta.filename }));\n * }\n * ```\n */\nexport const runApp = (opts: WorkerOptions) => {\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    .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      runWorker({\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      runWorker({\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      runWorker({\n        opts,\n        production: false,\n        watch: false,\n        room: options.room,\n        participantIdentity: options.participantIdentity,\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.js

@@ -1,131 +1,105 @@
-// SPDX-FileCopyrightText: 2024 LiveKit, Inc.
-//
-// SPDX-License-Identifier: Apache-2.0
-import { Command, Option } from 'commander';
-import { initializeLogger, log } from './log.js';
-import { version } from './version.js';
-import { Worker, WorkerOptions } from './worker.js';
+import { Command, Option } from "commander";
+import { initializeLogger, log } from "./log.js";
+import { version } from "./version.js";
+import { Worker, WorkerOptions } from "./worker.js";
 const runWorker = async (args) => {
-    initializeLogger({ pretty: !args.production, level: args.opts.logLevel });
-    const logger = log();
-    // though `production` is defined in WorkerOptions, it will always be overriddden by CLI.
-    const { production: _, ...opts } = args.opts; // eslint-disable-line @typescript-eslint/no-unused-vars
-    const worker = new Worker(new WorkerOptions({ production: args.production, ...opts }));
-    if (args.room) {
-        worker.event.once('worker_registered', () => {
-            logger.info(`connecting to room ${args.room}`);
-            worker.simulateJob(args.room, args.participantIdentity);
-        });
-    }
-    process.once('SIGINT', async () => {
-        // allow C-c C-c for force interrupt
-        process.once('SIGINT', () => {
-            logger.info('worker closed forcefully');
-            process.exit(130); // SIGINT exit code
-        });
-        if (args.production) {
-            await worker.drain();
-        }
-        await worker.close();
-        logger.info('worker closed');
-        process.exit(130); // SIGINT exit code
+  initializeLogger({ pretty: !args.production, level: args.opts.logLevel });
+  const logger = log();
+  const { production: _, ...opts } = args.opts;
+  const worker = new Worker(new WorkerOptions({ production: args.production, ...opts }));
+  if (args.room) {
+    worker.event.once("worker_registered", () => {
+      logger.info(`connecting to room ${args.room}`);
+      worker.simulateJob(args.room, args.participantIdentity);
     });
-    try {
-        await worker.run();
-    }
-    catch {
-        logger.fatal('worker failed');
-        process.exit(1);
+  }
+  process.once("SIGINT", async () => {
+    process.once("SIGINT", () => {
+      logger.info("worker closed forcefully");
+      process.exit(130);
+    });
+    if (args.production) {
+      await worker.drain();
     }
+    await worker.close();
+    logger.info("worker closed");
+    process.exit(130);
+  });
+  try {
+    await worker.run();
+  } catch {
+    logger.fatal("worker failed");
+    process.exit(1);
+  }
 };
-/**
- * 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 WorkerOptions({ agent: import.meta.filename }));
- * }
- * ```
- */
-export const runApp = (opts) => {
-    const program = new Command()
-        .name('agents')
-        .description('LiveKit Agents CLI')
-        .version(version)
-        .addOption(new Option('--log-level <level>', 'Set the logging level')
-        .choices(['trace', 'debug', 'info', 'warn', 'error', 'fatal'])
-        .default('info')
-        .env('LOG_LEVEL'))
-        .addOption(new Option('--url <string>', 'LiveKit server or Cloud project websocket URL').env('LIVEKIT_URL'))
-        .addOption(new Option('--api-key <string>', "LiveKit server or Cloud project's API key").env('LIVEKIT_API_KEY'))
-        .addOption(new Option('--api-secret <string>', "LiveKit server or Cloud project's API secret").env('LIVEKIT_API_SECRET'))
-        .action(() => {
-        if (
-        // do not run CLI if origin file is agents/ipc/job_main.js
-        process.argv[1] !== new URL('ipc/job_main.js', import.meta.url).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;
-        runWorker({
-            opts,
-            production: true,
-            watch: false,
-        });
+const runApp = (opts) => {
+  const program = new Command().name("agents").description("LiveKit Agents CLI").version(version).addOption(
+    new Option("--log-level <level>", "Set the logging level").choices(["trace", "debug", "info", "warn", "error", "fatal"]).default("info").env("LOG_LEVEL")
+  ).addOption(
+    new Option("--url <string>", "LiveKit server or Cloud project websocket URL").env(
+      "LIVEKIT_URL"
+    )
+  ).addOption(
+    new Option("--api-key <string>", "LiveKit server or Cloud project's API key").env(
+      "LIVEKIT_API_KEY"
+    )
+  ).addOption(
+    new Option("--api-secret <string>", "LiveKit server or Cloud project's API secret").env(
+      "LIVEKIT_API_SECRET"
+    )
+  ).action(() => {
+    if (
+      // do not run CLI if origin file is agents/ipc/job_main.js
+      process.argv[1] !== new URL("ipc/job_main.js", import.meta.url).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;
+    runWorker({
+      opts,
+      production: true,
+      watch: false
     });
-    program
-        .command('dev')
-        .description('Start the worker in development mode')
-        .addOption(new 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;
-        runWorker({
-            opts,
-            production: false,
-            watch: false,
-        });
+  });
+  program.command("dev").description("Start the worker in development mode").addOption(
+    new 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;
+    runWorker({
+      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 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;
-        runWorker({
-            opts,
-            production: false,
-            watch: false,
-            room: options.room,
-            participantIdentity: options.participantIdentity,
-        });
+  });
+  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 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;
+    runWorker({
+      opts,
+      production: false,
+      watch: false,
+      room: options.room,
+      participantIdentity: options.participantIdentity
     });
-    program.parse();
+  });
+  program.parse();
+};
+export {
+  runApp
 };
 //# sourceMappingURL=cli.js.map