@livekit/agents 0.1.0 → 0.3.0

package/.turbo/turbo-build.log

@@ -1,4 +1,4 @@
 
-> @livekit/agents@0.1.0 build /home/runner/work/agents-js/agents-js/agents
+> @livekit/agents@0.3.0 build /home/runner/work/agents-js/agents-js/agents
 > tsc
 

package/CHANGELOG.md

@@ -0,0 +1,47 @@
+# @livekit/agents
+
+## 0.3.0
+
+### Minor Changes
+
+- Rename to MultimodalAgent, move to main package - [#74](https://github.com/livekit/agents-js/pull/74) ([@bcherry](https://github.com/bcherry))
+
+- add waitForParticipant - [#73](https://github.com/livekit/agents-js/pull/73) ([@nbsp](https://github.com/nbsp))
+
+- omniassistant overhaul - [#65](https://github.com/livekit/agents-js/pull/65) ([@nbsp](https://github.com/nbsp))
+
+### Patch Changes
+
+- update rtc-node to 0.9.0 - [#73](https://github.com/livekit/agents-js/pull/73) ([@nbsp](https://github.com/nbsp))
+
+- improve dev mode default parameters - [#70](https://github.com/livekit/agents-js/pull/70) ([@nbsp](https://github.com/nbsp))
+
+- throw friendly error on --participant-identity err - [#61](https://github.com/livekit/agents-js/pull/61) ([@nbsp](https://github.com/nbsp))
+
+- shut everything down correctly - [#62](https://github.com/livekit/agents-js/pull/62) ([@nbsp](https://github.com/nbsp))
+
+- Maximize self-import compatibility - [#69](https://github.com/livekit/agents-js/pull/69) ([@bcherry](https://github.com/bcherry))
+
+- automatically no-op on CLI if executor is job_main - [#64](https://github.com/livekit/agents-js/pull/64) ([@nbsp](https://github.com/nbsp))
+
+- Allow passing required params in WorkerOptions - [#68](https://github.com/livekit/agents-js/pull/68) ([@bcherry](https://github.com/bcherry))
+
+## 0.2.0
+
+### Minor Changes
+
+- bump underlying dependencies - [`be7160d39ea57239a51fbf6ad2cbea1342cc1889`](https://github.com/livekit/agents-js/commit/be7160d39ea57239a51fbf6ad2cbea1342cc1889) ([@bcherry](https://github.com/bcherry))
+  fix load calculation
+  report worker status
+
+- cli: add runHeadless function - [`36c553a60fef7621b9c4232b5c79555b2f83aad8`](https://github.com/livekit/agents-js/commit/36c553a60fef7621b9c4232b5c79555b2f83aad8) ([@nbsp](https://github.com/nbsp))
+
+### Patch Changes
+
+- worker: JT\_{PUBLISHER => ROOM} - [`1c8caf04c148dfa57af4e844b6538d97d6be652a`](https://github.com/livekit/agents-js/commit/1c8caf04c148dfa57af4e844b6538d97d6be652a) ([@nbsp](https://github.com/nbsp))
+
+- Pass api key and secret to RoomServiceClient - [#58](https://github.com/livekit/agents-js/pull/58) ([@bcherry](https://github.com/bcherry))
+
+- Let defineAgent accept agent type - [`24a4f58a23d4a3aad8620fcccabdab5d2e1152c7`](https://github.com/livekit/agents-js/commit/24a4f58a23d4a3aad8620fcccabdab5d2e1152c7) ([@lukasIO](https://github.com/lukasIO))
+
+- Add transcript support to realtime voice assistant - [`1063d2a25c4a01022948699e673d267d04c1ec05`](https://github.com/livekit/agents-js/commit/1063d2a25c4a01022948699e673d267d04c1ec05) ([@bcherry](https://github.com/bcherry))

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/dist/audio.d.ts

@@ -0,0 +1,9 @@
+import { AudioFrame } from '@livekit/rtc-node';
+/** 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[];
+}
+//# 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":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C,uFAAuF;AACvF,qBAAa,eAAe;;gBAMd,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;CAetB"}

package/dist/audio.js

@@ -0,0 +1,54 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _AudioByteStream_sampleRate, _AudioByteStream_numChannels, _AudioByteStream_bytesPerFrame, _AudioByteStream_buf;
+// 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 {
+    constructor(sampleRate, numChannels, samplesPerChannel = null) {
+        _AudioByteStream_sampleRate.set(this, void 0);
+        _AudioByteStream_numChannels.set(this, void 0);
+        _AudioByteStream_bytesPerFrame.set(this, void 0);
+        _AudioByteStream_buf.set(this, void 0);
+        __classPrivateFieldSet(this, _AudioByteStream_sampleRate, sampleRate, "f");
+        __classPrivateFieldSet(this, _AudioByteStream_numChannels, numChannels, "f");
+        if (samplesPerChannel === null) {
+            samplesPerChannel = Math.floor(sampleRate / 50); // 20ms by default
+        }
+        __classPrivateFieldSet(this, _AudioByteStream_bytesPerFrame, numChannels * samplesPerChannel * 2, "f"); // 2 bytes per sample (Int16)
+        __classPrivateFieldSet(this, _AudioByteStream_buf, new Int8Array(), "f");
+    }
+    write(data) {
+        __classPrivateFieldSet(this, _AudioByteStream_buf, new Int8Array([...__classPrivateFieldGet(this, _AudioByteStream_buf, "f"), ...new Int8Array(data)]), "f");
+        const frames = [];
+        while (__classPrivateFieldGet(this, _AudioByteStream_buf, "f").length >= __classPrivateFieldGet(this, _AudioByteStream_bytesPerFrame, "f")) {
+            const frameData = __classPrivateFieldGet(this, _AudioByteStream_buf, "f").slice(0, __classPrivateFieldGet(this, _AudioByteStream_bytesPerFrame, "f"));
+            __classPrivateFieldSet(this, _AudioByteStream_buf, __classPrivateFieldGet(this, _AudioByteStream_buf, "f").slice(__classPrivateFieldGet(this, _AudioByteStream_bytesPerFrame, "f")), "f");
+            frames.push(new AudioFrame(new Int16Array(frameData.buffer), __classPrivateFieldGet(this, _AudioByteStream_sampleRate, "f"), __classPrivateFieldGet(this, _AudioByteStream_numChannels, "f"), frameData.length / 2));
+        }
+        return frames;
+    }
+    flush() {
+        if (__classPrivateFieldGet(this, _AudioByteStream_buf, "f").length % (2 * __classPrivateFieldGet(this, _AudioByteStream_numChannels, "f")) !== 0) {
+            log().warn('AudioByteStream: incomplete frame during flush, dropping');
+            return [];
+        }
+        return [
+            new AudioFrame(new Int16Array(__classPrivateFieldGet(this, _AudioByteStream_buf, "f").buffer), __classPrivateFieldGet(this, _AudioByteStream_sampleRate, "f"), __classPrivateFieldGet(this, _AudioByteStream_numChannels, "f"), __classPrivateFieldGet(this, _AudioByteStream_buf, "f").length / 2),
+        ];
+    }
+}
+_AudioByteStream_sampleRate = new WeakMap(), _AudioByteStream_numChannels = new WeakMap(), _AudioByteStream_bytesPerFrame = new WeakMap(), _AudioByteStream_buf = new WeakMap();
+//# sourceMappingURL=audio.js.map

package/dist/audio.js.map

@@ -0,0 +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;IAM1B,YAAY,UAAkB,EAAE,WAAmB,EAAE,oBAAmC,IAAI;QAL5F,8CAAoB;QACpB,+CAAqB;QACrB,iDAAuB;QACvB,uCAAgB;QAGd,uBAAA,IAAI,+BAAe,UAAU,MAAA,CAAC;QAC9B,uBAAA,IAAI,gCAAgB,WAAW,MAAA,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,uBAAA,IAAI,kCAAkB,WAAW,GAAG,iBAAiB,GAAG,CAAC,MAAA,CAAC,CAAC,6BAA6B;QACxF,uBAAA,IAAI,wBAAQ,IAAI,SAAS,EAAE,MAAA,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,IAAiB;QACrB,uBAAA,IAAI,wBAAQ,IAAI,SAAS,CAAC,CAAC,GAAG,uBAAA,IAAI,4BAAK,EAAE,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,MAAA,CAAC;QAElE,MAAM,MAAM,GAAiB,EAAE,CAAC;QAChC,OAAO,uBAAA,IAAI,4BAAK,CAAC,MAAM,IAAI,uBAAA,IAAI,sCAAe,EAAE,CAAC;YAC/C,MAAM,SAAS,GAAG,uBAAA,IAAI,4BAAK,CAAC,KAAK,CAAC,CAAC,EAAE,uBAAA,IAAI,sCAAe,CAAC,CAAC;YAC1D,uBAAA,IAAI,wBAAQ,uBAAA,IAAI,4BAAK,CAAC,KAAK,CAAC,uBAAA,IAAI,sCAAe,CAAC,MAAA,CAAC;YAEjD,MAAM,CAAC,IAAI,CACT,IAAI,UAAU,CACZ,IAAI,UAAU,CAAC,SAAS,CAAC,MAAM,CAAC,EAChC,uBAAA,IAAI,mCAAY,EAChB,uBAAA,IAAI,oCAAa,EACjB,SAAS,CAAC,MAAM,GAAG,CAAC,CACrB,CACF,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK;QACH,IAAI,uBAAA,IAAI,4BAAK,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,uBAAA,IAAI,oCAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YACrD,GAAG,EAAE,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAC;YACvE,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO;YACL,IAAI,UAAU,CACZ,IAAI,UAAU,CAAC,uBAAA,IAAI,4BAAK,CAAC,MAAM,CAAC,EAChC,uBAAA,IAAI,mCAAY,EAChB,uBAAA,IAAI,oCAAa,EACjB,uBAAA,IAAI,4BAAK,CAAC,MAAM,GAAG,CAAC,CACrB;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/cli.d.ts

@@ -1,3 +1,14 @@
-import { type WorkerOptions } from './worker.js';
+import { WorkerOptions } 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 WorkerOptions({ agent: import.meta.filename }));
+ * }
+ * ```
+ */
 export declare const runApp: (opts: WorkerOptions) => void;
 //# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAOA,OAAO,EAAU,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AA4BzD,eAAO,MAAM,MAAM,SAAU,aAAa,SA2CzC,CAAC"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAOA,OAAO,EAAU,aAAa,EAAE,MAAM,aAAa,CAAC;AA+CpD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,MAAM,SAAU,aAAa,SAqGzC,CAAC"}

package/dist/cli.js

@@ -1,26 +1,64 @@
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
 // SPDX-FileCopyrightText: 2024 LiveKit, Inc.
 //
 // SPDX-License-Identifier: Apache-2.0
 import { Command, Option } from 'commander';
-import { log } from './log.js';
+import { initializeLogger, log } from './log.js';
 import { version } from './version.js';
-import { Worker } from './worker.js';
+import { Worker, WorkerOptions } from './worker.js';
 const runWorker = async (args) => {
-    log.level = args.logLevel;
-    const worker = new Worker(args.opts);
-    process.on('SIGINT', async () => {
+    initializeLogger({ pretty: !args.production, level: args.opts.logLevel });
+    // though `production` is defined in WorkerOptions, it will always be overriddden by CLI.
+    const _a = args.opts, { production: _ } = _a, opts = __rest(_a, ["production"]); // eslint-disable-line @typescript-eslint/no-unused-vars
+    const worker = new Worker(new WorkerOptions(Object.assign({ production: args.production }, opts)));
+    if (args.room) {
+        worker.event.once('worker_registered', () => {
+            log().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', () => {
+            log().info('worker closed forcefully');
+            process.exit(130); // SIGINT exit code
+        });
+        if (args.production) {
+            await worker.drain();
+        }
         await worker.close();
-        log.info('worker closed');
+        log().info('worker closed');
         process.exit(130); // SIGINT exit code
     });
     try {
         await worker.run();
     }
-    catch {
-        log.fatal('worker failed');
+    catch (_b) {
+        log().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')
@@ -28,16 +66,19 @@ export const runApp = (opts) => {
         .version(version)
         .addOption(new Option('--log-level <level>', 'Set the logging level')
         .choices(['trace', 'debug', 'info', 'warn', 'error', 'fatal'])
-        .default('trace'))
-        .addOption(new Option('--url <string>', 'LiveKit server or Cloud project websocket URL')
-        .makeOptionMandatory(true)
-        .env('LIVEKIT_URL'))
-        .addOption(new Option('--api-key <string>', "LiveKit server or Cloud project's API key")
-        .makeOptionMandatory(true)
-        .env('LIVEKIT_API_KEY'))
-        .addOption(new Option('--api-secret <string>', "LiveKit server or Cloud project's API secret")
-        .makeOptionMandatory(true)
-        .env('LIVEKIT_API_SECRET'));
+        .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')
@@ -46,11 +87,53 @@ export const runApp = (opts) => {
         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,
-            logLevel: options.logLevel,
+        });
+    });
+    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.parse();

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,EAAE;AACF,sCAAsC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAE5C,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,MAAM,EAAsB,MAAM,aAAa,CAAC;AAUzD,MAAM,SAAS,GAAG,KAAK,EAAE,IAAa,EAAE,EAAE;IACxC,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC;IAC1B,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAErC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;QAC9B,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC1B,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,mBAAmB;IACxC,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,GAAG,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QAC3B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,IAAmB,EAAE,EAAE;IAC5C,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE;SAC1B,IAAI,CAAC,QAAQ,CAAC;SACd,WAAW,CAAC,oBAAoB,CAAC;SACjC,OAAO,CAAC,OAAO,CAAC;SAChB,SAAS,CACR,IAAI,MAAM,CAAC,qBAAqB,EAAE,uBAAuB,CAAC;SACvD,OAAO,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,OAAO,CAAC,OAAO,CAAC,CACpB;SACA,SAAS,CACR,IAAI,MAAM,CAAC,gBAAgB,EAAE,+CAA+C,CAAC;SAC1E,mBAAmB,CAAC,IAAI,CAAC;SACzB,GAAG,CAAC,aAAa,CAAC,CACtB;SACA,SAAS,CACR,IAAI,MAAM,CAAC,oBAAoB,EAAE,2CAA2C,CAAC;SAC1E,mBAAmB,CAAC,IAAI,CAAC;SACzB,GAAG,CAAC,iBAAiB,CAAC,CAC1B;SACA,SAAS,CACR,IAAI,MAAM,CAAC,uBAAuB,EAAE,8CAA8C,CAAC;SAChF,mBAAmB,CAAC,IAAI,CAAC;SACzB,GAAG,CAAC,oBAAoB,CAAC,CAC7B,CAAC;IAEJ,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,qCAAqC,CAAC;SAClD,MAAM,CAAC,GAAG,EAAE;QACX,MAAM,OAAO,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;QAC1C,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC;QACvC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC;QAC5C,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC;QACrD,SAAS,CAAC;YACR,IAAI;YACJ,UAAU,EAAE,IAAI;YAChB,KAAK,EAAE,KAAK;YACZ,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEL,OAAO,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/generator.d.ts

@@ -1,12 +1,23 @@
-import type { JobContext } from './job_context.js';
-type entryFunction = (job: JobContext) => Promise<void>;
+import type { JobContext, JobProcess } from './job.js';
+/** @see {@link defineAgent} */
 export interface Agent {
-    entry: entryFunction;
+    entry: (ctx: JobContext) => Promise<void>;
+    prewarm?: (proc: JobProcess) => unknown;
 }
+/** Helper to check if an object is an agent before running it.
+ *
+ * @internal
+ */
+export declare function isAgent(obj: unknown): obj is Agent;
 /**
  * Helper to define an agent according to the required interface.
- * @example `export default defineAgent(myAgent);`
+ * @example A basic agent with entry and prewarm functions
+ * ```
+ * export default defineAgent({
+ *   entry: async (ctx: JobContext) => { ... },
+ *   prewarm: (proc: JobProcess) => { ... },
+ * })
+ * ```
  */
-export declare function defineAgent(entry: entryFunction): Agent;
-export {};
+export declare function defineAgent(agent: Agent): Agent;
 //# sourceMappingURL=generator.d.ts.map

package/dist/generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,KAAK,aAAa,GAAG,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAExD,MAAM,WAAW,KAAK;IACpB,KAAK,EAAE,aAAa,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,KAAK,CAEvD"}
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEvD,+BAA+B;AAC/B,MAAM,WAAW,KAAK;IACpB,KAAK,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,OAAO,CAAC;CACzC;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,KAAK,CAQlD;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAE/C"}

package/dist/generator.js

@@ -1,8 +1,25 @@
+/** Helper to check if an object is an agent before running it.
+ *
+ * @internal
+ */
+export function isAgent(obj) {
+    return (typeof obj === 'object' &&
+        obj !== null &&
+        'entry' in obj &&
+        typeof obj.entry === 'function' &&
+        (('prewarm' in obj && typeof obj.prewarm === 'function') || !('prewarm' in obj)));
+}
 /**
  * Helper to define an agent according to the required interface.
- * @example `export default defineAgent(myAgent);`
+ * @example A basic agent with entry and prewarm functions
+ * ```
+ * export default defineAgent({
+ *   entry: async (ctx: JobContext) => { ... },
+ *   prewarm: (proc: JobProcess) => { ... },
+ * })
+ * ```
  */
-export function defineAgent(entry) {
-    return { entry };
+export function defineAgent(agent) {
+    return agent;
 }
 //# sourceMappingURL=generator.js.map

package/dist/generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"generator.js","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"AAWA;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAoB;IAC9C,OAAO,EAAE,KAAK,EAAE,CAAC;AACnB,CAAC"}
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"AAWA;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,GAAY;IAClC,OAAO,CACL,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,KAAK,IAAI;QACZ,OAAO,IAAI,GAAG;QACd,OAAQ,GAAa,CAAC,KAAK,KAAK,UAAU;QAC1C,CAAC,CAAC,SAAS,IAAI,GAAG,IAAI,OAAQ,GAAa,CAAC,OAAO,KAAK,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,IAAI,GAAG,CAAC,CAAC,CAC5F,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAAC,KAAY;IACtC,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/http_server.d.ts

@@ -1,4 +1,4 @@
-/// <reference types="node" resolution-mode="require"/>
+/// <reference types="node" />
 import { type Server } from 'http';
 export declare class HTTPServer {
     host: string;

package/dist/http_server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http_server.d.ts","sourceRoot":"","sources":["../src/http_server.ts"],"names":[],"mappings":";AAGA,OAAO,EAAwB,KAAK,MAAM,EAAqC,MAAM,MAAM,CAAC;AAO5F,qBAAa,UAAU;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;gBAEA,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAchC,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IASpB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ7B"}
+{"version":3,"file":"http_server.d.ts","sourceRoot":"","sources":["../src/http_server.ts"],"names":[],"mappings":";AAGA,OAAO,EAAwB,KAAK,MAAM,EAAqC,MAAM,MAAM,CAAC;AAQ5F,qBAAa,UAAU;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;gBAEA,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAchC,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAapB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ7B"}

package/dist/http_server.js

@@ -2,14 +2,12 @@
 //
 // SPDX-License-Identifier: Apache-2.0
 import { createServer } from 'http';
+import { log } from './log.js';
 const healthCheck = async (res) => {
     res.writeHead(200);
     res.end('OK');
 };
 export class HTTPServer {
-    host;
-    port;
-    app;
     constructor(host, port) {
         this.host = host;
         this.port = port;
@@ -28,6 +26,10 @@ export class HTTPServer {
             this.app.listen(this.port, this.host, (err) => {
                 if (err)
                     reject(err);
+                const address = this.app.address();
+                if (typeof address !== 'string') {
+                    log().info(`Server is listening on port ${address.port}`);
+                }
                 resolve();
             });
         });