@livekit/agents 1.1.0 → 1.2.1

package/dist/beta/workflows/task_group.cjs

@@ -0,0 +1,165 @@
+"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 task_group_exports = {};
+__export(task_group_exports, {
+  TaskGroup: () => TaskGroup
+});
+module.exports = __toCommonJS(task_group_exports);
+var import_zod = require("zod");
+var import_llm = require("../../llm/index.cjs");
+var import_agent = require("../../voice/agent.cjs");
+class OutOfScopeError extends import_llm.ToolError {
+  targetTaskIds;
+  constructor(targetTaskIds) {
+    super("out_of_scope");
+    this.targetTaskIds = targetTaskIds;
+  }
+}
+class TaskGroup extends import_agent.AgentTask {
+  _summarizeChatCtx;
+  _returnExceptions;
+  _visitedTasks = /* @__PURE__ */ new Set();
+  _registeredFactories = /* @__PURE__ */ new Map();
+  _taskCompletedCallback;
+  _currentTask;
+  constructor(options = {}) {
+    const { summarizeChatCtx = true, returnExceptions = false, chatCtx, onTaskCompleted } = options;
+    super({ instructions: "*empty*", chatCtx });
+    this._summarizeChatCtx = summarizeChatCtx;
+    this._returnExceptions = returnExceptions;
+    this._taskCompletedCallback = onTaskCompleted;
+  }
+  add(task, { id, description }) {
+    this._registeredFactories.set(id, { taskFactory: task, id, description });
+    return this;
+  }
+  async onEnter() {
+    const taskStack = [...this._registeredFactories.keys()];
+    const taskResults = {};
+    while (taskStack.length > 0) {
+      const taskId = taskStack.shift();
+      const factoryInfo = this._registeredFactories.get(taskId);
+      this._currentTask = factoryInfo.taskFactory();
+      const sharedChatCtx = this._chatCtx.copy();
+      await this._currentTask.updateChatCtx(sharedChatCtx);
+      const outOfScopeTool = this.buildOutOfScopeTool(taskId);
+      if (outOfScopeTool) {
+        await this._currentTask.updateTools({
+          ...this._currentTask.toolCtx,
+          out_of_scope: outOfScopeTool
+        });
+      }
+      try {
+        this._visitedTasks.add(taskId);
+        const res = await this._currentTask.run();
+        this._chatCtx.merge(this._currentTask.chatCtx.copy(), {
+          excludeInstructions: true
+        });
+        taskResults[taskId] = res;
+        if (this._taskCompletedCallback) {
+          await this._taskCompletedCallback({
+            agentTask: this._currentTask,
+            taskId,
+            result: res
+          });
+        }
+      } catch (e) {
+        if (e instanceof OutOfScopeError) {
+          taskStack.unshift(taskId);
+          for (let i = e.targetTaskIds.length - 1; i >= 0; i--) {
+            taskStack.unshift(e.targetTaskIds[i]);
+          }
+          continue;
+        }
+        if (this._returnExceptions) {
+          taskResults[taskId] = e;
+          continue;
+        } else {
+          this.complete(e instanceof Error ? e : new Error(String(e)));
+          return;
+        }
+      }
+    }
+    try {
+      if (this._summarizeChatCtx) {
+        const sessionLlm = this.session.llm;
+        if (!(sessionLlm instanceof import_llm.LLM)) {
+          throw new Error("summarizeChatCtx requires a standard LLM on the session");
+        }
+        const ctxToSummarize = this._chatCtx.copy({
+          excludeInstructions: false,
+          excludeFunctionCall: false,
+          excludeEmptyMessage: false,
+          excludeHandoff: false
+        });
+        const summarizedChatCtx = await ctxToSummarize._summarize(sessionLlm, {
+          keepLastTurns: 0
+        });
+        await this.updateChatCtx(summarizedChatCtx);
+      }
+    } catch (e) {
+      this.complete(new Error(`failed to summarize the chat_ctx: ${e}`));
+      return;
+    }
+    this.complete({ taskResults });
+  }
+  buildOutOfScopeTool(activeTaskId) {
+    if (this._visitedTasks.size === 0) {
+      return void 0;
+    }
+    const regressionTaskIds = new Set(this._visitedTasks);
+    regressionTaskIds.delete(activeTaskId);
+    if (regressionTaskIds.size === 0) {
+      return void 0;
+    }
+    const taskRepr = {};
+    for (const [id, info] of this._registeredFactories) {
+      if (regressionTaskIds.has(id)) {
+        taskRepr[id] = info.description;
+      }
+    }
+    const taskIdValues = [...regressionTaskIds];
+    const description = `Call to regress to other tasks according to what the user requested to modify, return the corresponding task ids. For example, if the user wants to change their email and there is a task with id "email_task" with a description of "Collect the user's email", return the id ("get_email_task"). If the user requests to regress to multiple tasks, such as changing their phone number and email, return both task ids in the order they were requested. The following are the IDs and their corresponding task description. ${JSON.stringify(taskRepr)}`;
+    const currentTask = this._currentTask;
+    const registeredFactories = this._registeredFactories;
+    const visitedTasks = this._visitedTasks;
+    return (0, import_llm.tool)({
+      description,
+      flags: import_llm.ToolFlag.IGNORE_ON_ENTER,
+      parameters: import_zod.z.object({
+        task_ids: import_zod.z.array(import_zod.z.enum(taskIdValues)).describe("The IDs of the tasks requested")
+      }),
+      execute: async ({ task_ids }) => {
+        for (const tid of task_ids) {
+          if (!registeredFactories.has(tid) || !visitedTasks.has(tid)) {
+            throw new import_llm.ToolError(`Unable to regress, invalid task id ${tid}`);
+          }
+        }
+        if (currentTask && !currentTask.done) {
+          currentTask.complete(new OutOfScopeError(task_ids));
+        }
+      }
+    });
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  TaskGroup
+});
+//# sourceMappingURL=task_group.cjs.map

package/dist/beta/workflows/task_group.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/beta/workflows/task_group.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2026 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { z } from 'zod';\nimport type { ChatContext } from '../../llm/chat_context.js';\nimport { LLM, ToolError, ToolFlag, tool } from '../../llm/index.js';\nimport { AgentTask } from '../../voice/agent.js';\n\ninterface FactoryInfo {\n  taskFactory: () => AgentTask;\n  id: string;\n  description: string;\n}\n\nexport interface TaskGroupResult {\n  taskResults: Record<string, unknown>;\n}\n\nexport interface TaskCompletedEvent {\n  agentTask: AgentTask;\n  taskId: string;\n  result: unknown;\n}\n\nclass OutOfScopeError extends ToolError {\n  readonly targetTaskIds: string[];\n\n  constructor(targetTaskIds: string[]) {\n    super('out_of_scope');\n    this.targetTaskIds = targetTaskIds;\n  }\n}\n\nexport interface TaskGroupOptions {\n  summarizeChatCtx?: boolean;\n  returnExceptions?: boolean;\n  chatCtx?: ChatContext;\n  onTaskCompleted?: (event: TaskCompletedEvent) => Promise<void>;\n}\n\nexport class TaskGroup extends AgentTask<TaskGroupResult> {\n  private _summarizeChatCtx: boolean;\n  private _returnExceptions: boolean;\n  private _visitedTasks = new Set<string>();\n  private _registeredFactories = new Map<string, FactoryInfo>();\n  private _taskCompletedCallback?: (event: TaskCompletedEvent) => Promise<void>;\n  private _currentTask?: AgentTask;\n\n  constructor(options: TaskGroupOptions = {}) {\n    const { summarizeChatCtx = true, returnExceptions = false, chatCtx, onTaskCompleted } = options;\n\n    super({ instructions: '*empty*', chatCtx });\n\n    this._summarizeChatCtx = summarizeChatCtx;\n    this._returnExceptions = returnExceptions;\n    this._taskCompletedCallback = onTaskCompleted;\n  }\n\n  add(task: () => AgentTask, { id, description }: { id: string; description: string }): this {\n    this._registeredFactories.set(id, { taskFactory: task, id, description });\n    return this;\n  }\n\n  async onEnter(): Promise<void> {\n    const taskStack = [...this._registeredFactories.keys()];\n    const taskResults: Record<string, unknown> = {};\n\n    while (taskStack.length > 0) {\n      const taskId = taskStack.shift()!;\n      const factoryInfo = this._registeredFactories.get(taskId)!;\n\n      this._currentTask = factoryInfo.taskFactory();\n\n      const sharedChatCtx = this._chatCtx.copy();\n      await this._currentTask.updateChatCtx(sharedChatCtx);\n\n      const outOfScopeTool = this.buildOutOfScopeTool(taskId);\n      if (outOfScopeTool) {\n        await this._currentTask.updateTools({\n          ...this._currentTask.toolCtx,\n          out_of_scope: outOfScopeTool,\n        });\n      }\n\n      try {\n        this._visitedTasks.add(taskId);\n        const res = await this._currentTask.run();\n\n        // AgentTask handoff merges omit function calls. Re-merge the completed\n        // task context so task-group summarization can incorporate tool results.\n        this._chatCtx.merge(this._currentTask.chatCtx.copy(), {\n          excludeInstructions: true,\n        });\n\n        taskResults[taskId] = res;\n\n        if (this._taskCompletedCallback) {\n          await this._taskCompletedCallback({\n            agentTask: this._currentTask,\n            taskId,\n            result: res,\n          });\n        }\n      } catch (e) {\n        if (e instanceof OutOfScopeError) {\n          taskStack.unshift(taskId);\n          for (let i = e.targetTaskIds.length - 1; i >= 0; i--) {\n            taskStack.unshift(e.targetTaskIds[i]!);\n          }\n          continue;\n        }\n\n        if (this._returnExceptions) {\n          taskResults[taskId] = e;\n          continue;\n        } else {\n          this.complete(e instanceof Error ? e : new Error(String(e)));\n          return;\n        }\n      }\n    }\n\n    try {\n      if (this._summarizeChatCtx) {\n        const sessionLlm = this.session.llm;\n        if (!(sessionLlm instanceof LLM)) {\n          throw new Error('summarizeChatCtx requires a standard LLM on the session');\n        }\n\n        // Keep the full item stream so summarization can distill tool results\n        // into the history summary instead of dropping them up front.\n        const ctxToSummarize = this._chatCtx.copy({\n          excludeInstructions: false,\n          excludeFunctionCall: false,\n          excludeEmptyMessage: false,\n          excludeHandoff: false,\n        });\n\n        const summarizedChatCtx = await ctxToSummarize._summarize(sessionLlm, {\n          keepLastTurns: 0,\n        });\n\n        await this.updateChatCtx(summarizedChatCtx);\n      }\n    } catch (e) {\n      this.complete(new Error(`failed to summarize the chat_ctx: ${e}`));\n      return;\n    }\n\n    this.complete({ taskResults });\n  }\n\n  private buildOutOfScopeTool(activeTaskId: string) {\n    if (this._visitedTasks.size === 0) {\n      return undefined;\n    }\n\n    const regressionTaskIds = new Set(this._visitedTasks);\n    regressionTaskIds.delete(activeTaskId);\n\n    if (regressionTaskIds.size === 0) {\n      return undefined;\n    }\n\n    const taskRepr: Record<string, string> = {};\n    for (const [id, info] of this._registeredFactories) {\n      if (regressionTaskIds.has(id)) {\n        taskRepr[id] = info.description;\n      }\n    }\n\n    const taskIdValues = [...regressionTaskIds] as [string, ...string[]];\n\n    const description =\n      'Call to regress to other tasks according to what the user requested to modify, return the corresponding task ids. ' +\n      'For example, if the user wants to change their email and there is a task with id \"email_task\" with a description of \"Collect the user\\'s email\", return the id (\"get_email_task\"). ' +\n      'If the user requests to regress to multiple tasks, such as changing their phone number and email, return both task ids in the order they were requested. ' +\n      `The following are the IDs and their corresponding task description. ${JSON.stringify(taskRepr)}`;\n\n    const currentTask = this._currentTask;\n    const registeredFactories = this._registeredFactories;\n    const visitedTasks = this._visitedTasks;\n\n    return tool({\n      description,\n      flags: ToolFlag.IGNORE_ON_ENTER,\n      parameters: z.object({\n        task_ids: z.array(z.enum(taskIdValues)).describe('The IDs of the tasks requested'),\n      }),\n      execute: async ({ task_ids }: { task_ids: string[] }) => {\n        for (const tid of task_ids) {\n          if (!registeredFactories.has(tid) || !visitedTasks.has(tid)) {\n            throw new ToolError(`Unable to regress, invalid task id ${tid}`);\n          }\n        }\n\n        if (currentTask && !currentTask.done) {\n          currentTask.complete(new OutOfScopeError(task_ids));\n        }\n      },\n    });\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/beta/workflows/task_group.d.cts

@@ -0,0 +1,32 @@
+import type { ChatContext } from '../../llm/chat_context.js';
+import { AgentTask } from '../../voice/agent.js';
+export interface TaskGroupResult {
+    taskResults: Record<string, unknown>;
+}
+export interface TaskCompletedEvent {
+    agentTask: AgentTask;
+    taskId: string;
+    result: unknown;
+}
+export interface TaskGroupOptions {
+    summarizeChatCtx?: boolean;
+    returnExceptions?: boolean;
+    chatCtx?: ChatContext;
+    onTaskCompleted?: (event: TaskCompletedEvent) => Promise<void>;
+}
+export declare class TaskGroup extends AgentTask<TaskGroupResult> {
+    private _summarizeChatCtx;
+    private _returnExceptions;
+    private _visitedTasks;
+    private _registeredFactories;
+    private _taskCompletedCallback?;
+    private _currentTask?;
+    constructor(options?: TaskGroupOptions);
+    add(task: () => AgentTask, { id, description }: {
+        id: string;
+        description: string;
+    }): this;
+    onEnter(): Promise<void>;
+    private buildOutOfScopeTool;
+}
+//# sourceMappingURL=task_group.d.ts.map

package/dist/beta/workflows/task_group.d.ts

@@ -0,0 +1,32 @@
+import type { ChatContext } from '../../llm/chat_context.js';
+import { AgentTask } from '../../voice/agent.js';
+export interface TaskGroupResult {
+    taskResults: Record<string, unknown>;
+}
+export interface TaskCompletedEvent {
+    agentTask: AgentTask;
+    taskId: string;
+    result: unknown;
+}
+export interface TaskGroupOptions {
+    summarizeChatCtx?: boolean;
+    returnExceptions?: boolean;
+    chatCtx?: ChatContext;
+    onTaskCompleted?: (event: TaskCompletedEvent) => Promise<void>;
+}
+export declare class TaskGroup extends AgentTask<TaskGroupResult> {
+    private _summarizeChatCtx;
+    private _returnExceptions;
+    private _visitedTasks;
+    private _registeredFactories;
+    private _taskCompletedCallback?;
+    private _currentTask?;
+    constructor(options?: TaskGroupOptions);
+    add(task: () => AgentTask, { id, description }: {
+        id: string;
+        description: string;
+    }): this;
+    onEnter(): Promise<void>;
+    private buildOutOfScopeTool;
+}
+//# sourceMappingURL=task_group.d.ts.map

package/dist/beta/workflows/task_group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task_group.d.ts","sourceRoot":"","sources":["../../../src/beta/workflows/task_group.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAQjD,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB;AAWD,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAChE;AAED,qBAAa,SAAU,SAAQ,SAAS,CAAC,eAAe,CAAC;IACvD,OAAO,CAAC,iBAAiB,CAAU;IACnC,OAAO,CAAC,iBAAiB,CAAU;IACnC,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,oBAAoB,CAAkC;IAC9D,OAAO,CAAC,sBAAsB,CAAC,CAA+C;IAC9E,OAAO,CAAC,YAAY,CAAC,CAAY;gBAErB,OAAO,GAAE,gBAAqB;IAU1C,GAAG,CAAC,IAAI,EAAE,MAAM,SAAS,EAAE,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAKpF,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAyF9B,OAAO,CAAC,mBAAmB;CAkD5B"}

package/dist/beta/workflows/task_group.js

@@ -0,0 +1,141 @@
+import { z } from "zod";
+import { LLM, ToolError, ToolFlag, tool } from "../../llm/index.js";
+import { AgentTask } from "../../voice/agent.js";
+class OutOfScopeError extends ToolError {
+  targetTaskIds;
+  constructor(targetTaskIds) {
+    super("out_of_scope");
+    this.targetTaskIds = targetTaskIds;
+  }
+}
+class TaskGroup extends AgentTask {
+  _summarizeChatCtx;
+  _returnExceptions;
+  _visitedTasks = /* @__PURE__ */ new Set();
+  _registeredFactories = /* @__PURE__ */ new Map();
+  _taskCompletedCallback;
+  _currentTask;
+  constructor(options = {}) {
+    const { summarizeChatCtx = true, returnExceptions = false, chatCtx, onTaskCompleted } = options;
+    super({ instructions: "*empty*", chatCtx });
+    this._summarizeChatCtx = summarizeChatCtx;
+    this._returnExceptions = returnExceptions;
+    this._taskCompletedCallback = onTaskCompleted;
+  }
+  add(task, { id, description }) {
+    this._registeredFactories.set(id, { taskFactory: task, id, description });
+    return this;
+  }
+  async onEnter() {
+    const taskStack = [...this._registeredFactories.keys()];
+    const taskResults = {};
+    while (taskStack.length > 0) {
+      const taskId = taskStack.shift();
+      const factoryInfo = this._registeredFactories.get(taskId);
+      this._currentTask = factoryInfo.taskFactory();
+      const sharedChatCtx = this._chatCtx.copy();
+      await this._currentTask.updateChatCtx(sharedChatCtx);
+      const outOfScopeTool = this.buildOutOfScopeTool(taskId);
+      if (outOfScopeTool) {
+        await this._currentTask.updateTools({
+          ...this._currentTask.toolCtx,
+          out_of_scope: outOfScopeTool
+        });
+      }
+      try {
+        this._visitedTasks.add(taskId);
+        const res = await this._currentTask.run();
+        this._chatCtx.merge(this._currentTask.chatCtx.copy(), {
+          excludeInstructions: true
+        });
+        taskResults[taskId] = res;
+        if (this._taskCompletedCallback) {
+          await this._taskCompletedCallback({
+            agentTask: this._currentTask,
+            taskId,
+            result: res
+          });
+        }
+      } catch (e) {
+        if (e instanceof OutOfScopeError) {
+          taskStack.unshift(taskId);
+          for (let i = e.targetTaskIds.length - 1; i >= 0; i--) {
+            taskStack.unshift(e.targetTaskIds[i]);
+          }
+          continue;
+        }
+        if (this._returnExceptions) {
+          taskResults[taskId] = e;
+          continue;
+        } else {
+          this.complete(e instanceof Error ? e : new Error(String(e)));
+          return;
+        }
+      }
+    }
+    try {
+      if (this._summarizeChatCtx) {
+        const sessionLlm = this.session.llm;
+        if (!(sessionLlm instanceof LLM)) {
+          throw new Error("summarizeChatCtx requires a standard LLM on the session");
+        }
+        const ctxToSummarize = this._chatCtx.copy({
+          excludeInstructions: false,
+          excludeFunctionCall: false,
+          excludeEmptyMessage: false,
+          excludeHandoff: false
+        });
+        const summarizedChatCtx = await ctxToSummarize._summarize(sessionLlm, {
+          keepLastTurns: 0
+        });
+        await this.updateChatCtx(summarizedChatCtx);
+      }
+    } catch (e) {
+      this.complete(new Error(`failed to summarize the chat_ctx: ${e}`));
+      return;
+    }
+    this.complete({ taskResults });
+  }
+  buildOutOfScopeTool(activeTaskId) {
+    if (this._visitedTasks.size === 0) {
+      return void 0;
+    }
+    const regressionTaskIds = new Set(this._visitedTasks);
+    regressionTaskIds.delete(activeTaskId);
+    if (regressionTaskIds.size === 0) {
+      return void 0;
+    }
+    const taskRepr = {};
+    for (const [id, info] of this._registeredFactories) {
+      if (regressionTaskIds.has(id)) {
+        taskRepr[id] = info.description;
+      }
+    }
+    const taskIdValues = [...regressionTaskIds];
+    const description = `Call to regress to other tasks according to what the user requested to modify, return the corresponding task ids. For example, if the user wants to change their email and there is a task with id "email_task" with a description of "Collect the user's email", return the id ("get_email_task"). If the user requests to regress to multiple tasks, such as changing their phone number and email, return both task ids in the order they were requested. The following are the IDs and their corresponding task description. ${JSON.stringify(taskRepr)}`;
+    const currentTask = this._currentTask;
+    const registeredFactories = this._registeredFactories;
+    const visitedTasks = this._visitedTasks;
+    return tool({
+      description,
+      flags: ToolFlag.IGNORE_ON_ENTER,
+      parameters: z.object({
+        task_ids: z.array(z.enum(taskIdValues)).describe("The IDs of the tasks requested")
+      }),
+      execute: async ({ task_ids }) => {
+        for (const tid of task_ids) {
+          if (!registeredFactories.has(tid) || !visitedTasks.has(tid)) {
+            throw new ToolError(`Unable to regress, invalid task id ${tid}`);
+          }
+        }
+        if (currentTask && !currentTask.done) {
+          currentTask.complete(new OutOfScopeError(task_ids));
+        }
+      }
+    });
+  }
+}
+export {
+  TaskGroup
+};
+//# sourceMappingURL=task_group.js.map

package/dist/beta/workflows/task_group.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/beta/workflows/task_group.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2026 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { z } from 'zod';\nimport type { ChatContext } from '../../llm/chat_context.js';\nimport { LLM, ToolError, ToolFlag, tool } from '../../llm/index.js';\nimport { AgentTask } from '../../voice/agent.js';\n\ninterface FactoryInfo {\n  taskFactory: () => AgentTask;\n  id: string;\n  description: string;\n}\n\nexport interface TaskGroupResult {\n  taskResults: Record<string, unknown>;\n}\n\nexport interface TaskCompletedEvent {\n  agentTask: AgentTask;\n  taskId: string;\n  result: unknown;\n}\n\nclass OutOfScopeError extends ToolError {\n  readonly targetTaskIds: string[];\n\n  constructor(targetTaskIds: string[]) {\n    super('out_of_scope');\n    this.targetTaskIds = targetTaskIds;\n  }\n}\n\nexport interface TaskGroupOptions {\n  summarizeChatCtx?: boolean;\n  returnExceptions?: boolean;\n  chatCtx?: ChatContext;\n  onTaskCompleted?: (event: TaskCompletedEvent) => Promise<void>;\n}\n\nexport class TaskGroup extends AgentTask<TaskGroupResult> {\n  private _summarizeChatCtx: boolean;\n  private _returnExceptions: boolean;\n  private _visitedTasks = new Set<string>();\n  private _registeredFactories = new Map<string, FactoryInfo>();\n  private _taskCompletedCallback?: (event: TaskCompletedEvent) => Promise<void>;\n  private _currentTask?: AgentTask;\n\n  constructor(options: TaskGroupOptions = {}) {\n    const { summarizeChatCtx = true, returnExceptions = false, chatCtx, onTaskCompleted } = options;\n\n    super({ instructions: '*empty*', chatCtx });\n\n    this._summarizeChatCtx = summarizeChatCtx;\n    this._returnExceptions = returnExceptions;\n    this._taskCompletedCallback = onTaskCompleted;\n  }\n\n  add(task: () => AgentTask, { id, description }: { id: string; description: string }): this {\n    this._registeredFactories.set(id, { taskFactory: task, id, description });\n    return this;\n  }\n\n  async onEnter(): Promise<void> {\n    const taskStack = [...this._registeredFactories.keys()];\n    const taskResults: Record<string, unknown> = {};\n\n    while (taskStack.length > 0) {\n      const taskId = taskStack.shift()!;\n      const factoryInfo = this._registeredFactories.get(taskId)!;\n\n      this._currentTask = factoryInfo.taskFactory();\n\n      const sharedChatCtx = this._chatCtx.copy();\n      await this._currentTask.updateChatCtx(sharedChatCtx);\n\n      const outOfScopeTool = this.buildOutOfScopeTool(taskId);\n      if (outOfScopeTool) {\n        await this._currentTask.updateTools({\n          ...this._currentTask.toolCtx,\n          out_of_scope: outOfScopeTool,\n        });\n      }\n\n      try {\n        this._visitedTasks.add(taskId);\n        const res = await this._currentTask.run();\n\n        // AgentTask handoff merges omit function calls. Re-merge the completed\n        // task context so task-group summarization can incorporate tool results.\n        this._chatCtx.merge(this._currentTask.chatCtx.copy(), {\n          excludeInstructions: true,\n        });\n\n        taskResults[taskId] = res;\n\n        if (this._taskCompletedCallback) {\n          await this._taskCompletedCallback({\n            agentTask: this._currentTask,\n            taskId,\n            result: res,\n          });\n        }\n      } catch (e) {\n        if (e instanceof OutOfScopeError) {\n          taskStack.unshift(taskId);\n          for (let i = e.targetTaskIds.length - 1; i >= 0; i--) {\n            taskStack.unshift(e.targetTaskIds[i]!);\n          }\n          continue;\n        }\n\n        if (this._returnExceptions) {\n          taskResults[taskId] = e;\n          continue;\n        } else {\n          this.complete(e instanceof Error ? e : new Error(String(e)));\n          return;\n        }\n      }\n    }\n\n    try {\n      if (this._summarizeChatCtx) {\n        const sessionLlm = this.session.llm;\n        if (!(sessionLlm instanceof LLM)) {\n          throw new Error('summarizeChatCtx requires a standard LLM on the session');\n        }\n\n        // Keep the full item stream so summarization can distill tool results\n        // into the history summary instead of dropping them up front.\n        const ctxToSummarize = this._chatCtx.copy({\n          excludeInstructions: false,\n          excludeFunctionCall: false,\n          excludeEmptyMessage: false,\n          excludeHandoff: false,\n        });\n\n        const summarizedChatCtx = await ctxToSummarize._summarize(sessionLlm, {\n          keepLastTurns: 0,\n        });\n\n        await this.updateChatCtx(summarizedChatCtx);\n      }\n    } catch (e) {\n      this.complete(new Error(`failed to summarize the chat_ctx: ${e}`));\n      return;\n    }\n\n    this.complete({ taskResults });\n  }\n\n  private buildOutOfScopeTool(activeTaskId: string) {\n    if (this._visitedTasks.size === 0) {\n      return undefined;\n    }\n\n    const regressionTaskIds = new Set(this._visitedTasks);\n    regressionTaskIds.delete(activeTaskId);\n\n    if (regressionTaskIds.size === 0) {\n      return undefined;\n    }\n\n    const taskRepr: Record<string, string> = {};\n    for (const [id, info] of this._registeredFactories) {\n      if (regressionTaskIds.has(id)) {\n        taskRepr[id] = info.description;\n      }\n    }\n\n    const taskIdValues = [...regressionTaskIds] as [string, ...string[]];\n\n    const description =\n      'Call to regress to other tasks according to what the user requested to modify, return the corresponding task ids. ' +\n      'For example, if the user wants to change their email and there is a task with id \"email_task\" with a description of \"Collect the user\\'s email\", return the id (\"get_email_task\"). ' +\n      'If the user requests to regress to multiple tasks, such as changing their phone number and email, return both task ids in the order they were requested. ' +\n      `The following are the IDs and their corresponding task description. ${JSON.stringify(taskRepr)}`;\n\n    const currentTask = this._currentTask;\n    const registeredFactories = this._registeredFactories;\n    const visitedTasks = this._visitedTasks;\n\n    return tool({\n      description,\n      flags: ToolFlag.IGNORE_ON_ENTER,\n      parameters: z.object({\n        task_ids: z.array(z.enum(taskIdValues)).describe('The IDs of the tasks requested'),\n      }),\n      execute: async ({ task_ids }: { task_ids: string[] }) => {\n        for (const tid of task_ids) {\n          if (!registeredFactories.has(tid) || !visitedTasks.has(tid)) {\n            throw new ToolError(`Unable to regress, invalid task id ${tid}`);\n          }\n        }\n\n        if (currentTask && !currentTask.done) {\n          currentTask.complete(new OutOfScopeError(task_ids));\n        }\n      },\n    });\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/cli.cjs

@@ -28,15 +28,15 @@ 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 runWorker = async (args) => {
+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 worker = new import_worker.Worker(new import_worker.WorkerOptions({ production: args.production, ...opts }));
+  const server = new import_worker.AgentServer(new import_worker.ServerOptions({ production: args.production, ...opts }));
   if (args.room) {
-    worker.event.once("worker_registered", () => {
+    server.event.once("worker_registered", () => {
       logger.info(`connecting to room ${args.room}`);
-      worker.simulateJob(args.room, args.participantIdentity);
+      server.simulateJob(args.room, args.participantIdentity);
     });
   }
   process.once("SIGINT", async () => {
@@ -46,32 +46,31 @@ const runWorker = async (args) => {
       process.exit(130);
     });
     if (args.production) {
-      await worker.drain();
+      await server.drain();
     }
-    await worker.close();
+    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 worker.drain();
+      await server.drain();
     }
-    await worker.close();
+    await server.close();
     logger.debug("worker closed due to SIGTERM.");
     process.exit(143);
   });
   try {
-    await worker.run();
+    await server.run();
   } catch {
     logger.fatal("closing worker due to error.");
     process.exit(1);
   }
 };
 const runApp = (opts) => {
+  const logLevelOption = (defaultLevel) => new import_commander.Option("--log-level <level>", "Set the logging level").choices(["trace", "debug", "info", "warn", "error", "fatal"]).default(defaultLevel).env("LOG_LEVEL");
   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"
     )
@@ -93,56 +92,55 @@ const runApp = (opts) => {
       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;
-    runWorker({
+  program.command("start").description("Start the worker in production mode").addOption(logLevelOption("info")).action((...[, command]) => {
+    const globalOptions = program.optsWithGlobals();
+    const commandOptions = command.opts();
+    opts.wsURL = globalOptions.url || opts.wsURL;
+    opts.apiKey = globalOptions.apiKey || opts.apiKey;
+    opts.apiSecret = globalOptions.apiSecret || opts.apiSecret;
+    opts.logLevel = commandOptions.logLevel;
+    opts.workerToken = globalOptions.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;
-    runWorker({
+  program.command("dev").description("Start the worker in development mode").addOption(logLevelOption("debug")).action((...[, command]) => {
+    const globalOptions = program.optsWithGlobals();
+    const commandOptions = command.opts();
+    opts.wsURL = globalOptions.url || opts.wsURL;
+    opts.apiKey = globalOptions.apiKey || opts.apiKey;
+    opts.apiSecret = globalOptions.apiSecret || opts.apiSecret;
+    opts.logLevel = commandOptions.logLevel;
+    opts.workerToken = globalOptions.workerToken || opts.workerToken;
+    process.env.LIVEKIT_DEV_MODE = "1";
+    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;
-    runWorker({
+  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(logLevelOption("info")).action((...[, command]) => {
+    const globalOptions = program.optsWithGlobals();
+    const commandOptions = command.opts();
+    opts.wsURL = globalOptions.url || opts.wsURL;
+    opts.apiKey = globalOptions.apiKey || opts.apiKey;
+    opts.apiSecret = globalOptions.apiSecret || opts.apiSecret;
+    opts.logLevel = commandOptions.logLevel;
+    opts.workerToken = globalOptions.workerToken || opts.workerToken;
+    process.env.LIVEKIT_DEV_MODE = "1";
+    runServer({
       opts,
       production: false,
       watch: false,
-      room: options.room,
-      participantIdentity: options.participantIdentity
+      room: commandOptions.room,
+      participantIdentity: commandOptions.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 });
+  program.command("download-files").description("Download plugin dependency files").addOption(logLevelOption("debug")).action((...[, command]) => {
+    const commandOptions = command.opts();
+    (0, import_log.initializeLogger)({ pretty: true, level: commandOptions.logLevel });
     const logger = (0, import_log.log)();
     const downloadFiles = async () => {
       for (const plugin of import_plugin.Plugin.registeredPlugins) {

package/dist/cli.cjs.map

@@ -1 +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.4.38_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 { 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 overridden 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    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 worker.drain();\n    }\n    await worker.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 worker.drain();\n    }\n    await worker.close();\n    logger.debug('worker closed due to SIGTERM.');\n    process.exit(143); // SIGTERM exit code\n  });\n\n  try {\n    await worker.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 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    .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      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      opts.workerToken = options.workerToken || opts.workerToken;\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      opts.workerToken = options.workerToken || opts.workerToken;\n      runWorker({\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":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;ACKA,IAAM,mBAAmB,MACvB,OAAO,aAAa,cAChB,IAAI,IAAI,QAAQ,UAAU,EAAE,EAAE,OAC7B,SAAS,iBAAiB,SAAS,cAAc,OAClD,IAAI,IAAI,WAAW,SAAS,OAAO,EAAE;AAEpC,IAAM,gBAAgC,iCAAiB;ADR9D,uBAAgC;AAEhC,iBAAsC;AACtC,oBAAuB;AACvB,qBAAwB;AACxB,oBAAsC;AAWtC,MAAM,YAAY,OAAO,SAAkB;AACzC,mCAAiB,EAAE,QAAQ,CAAC,KAAK,YAAY,OAAO,KAAK,KAAK,SAAS,CAAC;AACxE,QAAM,aAAS,gBAAI;AAGnB,QAAM,EAAE,YAAY,GAAG,GAAG,KAAK,IAAI,KAAK;AACxC,QAAM,SAAS,IAAI,qBAAO,IAAI,4BAAc,EAAE,YAAY,KAAK,YAAY,GAAG,KAAK,CAAC,CAAC;AAErF,MAAI,KAAK,MAAM;AACb,WAAO,MAAM,KAAK,qBAAqB,MAAM;AAC3C,aAAO,KAAK,sBAAsB,KAAK,IAAI,EAAE;AAC7C,aAAO,YAAY,KAAK,MAAO,KAAK,mBAAmB;AAAA,IACzD,CAAC;AAAA,EACH;AAEA,UAAQ,KAAK,UAAU,YAAY;AACjC,WAAO,MAAM,wBAAwB;AAErC,YAAQ,KAAK,UAAU,MAAM;AAC3B,cAAQ,IAAI,mCAAmC;AAC/C,cAAQ,KAAK,GAAG;AAAA,IAClB,CAAC;AACD,QAAI,KAAK,YAAY;AACnB,YAAM,OAAO,MAAM;AAAA,IACrB;AACA,UAAM,OAAO,MAAM;AACnB,WAAO,MAAM,8BAA8B;AAC3C,YAAQ,KAAK,GAAG;AAAA,EAClB,CAAC;AAED,UAAQ,KAAK,WAAW,YAAY;AAClC,WAAO,MAAM,0BAA0B;AACvC,QAAI,KAAK,YAAY;AACnB,YAAM,OAAO,MAAM;AAAA,IACrB;AACA,UAAM,OAAO,MAAM;AACnB,WAAO,MAAM,+BAA+B;AAC5C,YAAQ,KAAK,GAAG;AAAA,EAClB,CAAC;AAED,MAAI;AACF,UAAM,OAAO,IAAI;AAAA,EACnB,QAAQ;AACN,WAAO,MAAM,8BAA8B;AAC3C,YAAQ,KAAK,CAAC;AAAA,EAChB;AACF;AAaO,MAAM,SAAS,CAAC,SAAwB;AAC7C,QAAM,UAAU,IAAI,yBAAQ,EACzB,KAAK,QAAQ,EACb,YAAY,oBAAoB,EAChC,QAAQ,sBAAO,EACf;AAAA,IACC,IAAI,wBAAO,uBAAuB,uBAAuB,EACtD,QAAQ,CAAC,SAAS,SAAS,QAAQ,QAAQ,SAAS,OAAO,CAAC,EAC5D,QAAQ,MAAM,EACd,IAAI,WAAW;AAAA,EACpB,EACC;AAAA,IACC,IAAI,wBAAO,kBAAkB,+CAA+C,EAAE;AAAA,MAC5E;AAAA,IACF;AAAA,EACF,EACC;AAAA,IACC,IAAI,wBAAO,sBAAsB,2CAA2C,EAAE;AAAA,MAC5E;AAAA,IACF;AAAA,EACF,EACC;AAAA,IACC,IAAI,wBAAO,yBAAyB,8CAA8C,EAAE;AAAA,MAClF;AAAA,IACF;AAAA,EACF,EACC;AAAA,IACC,IAAI,wBAAO,2BAA2B,mBAAmB,EACtD,IAAI,sBAAsB,EAC1B,SAAS;AAAA,EACd,EACC,OAAO,MAAM;AACZ;AAAA;AAAA,MAEE,QAAQ,KAAK,CAAC,MAAM,IAAI,IAAI,mBAAmB,aAAe,EAAE,YAChE,QAAQ,KAAK,SAAS;AAAA,MACtB;AACA,cAAQ,KAAK;AAAA,IACf;AAAA,EACF,CAAC;AAEH,UACG,QAAQ,OAAO,EACf,YAAY,qCAAqC,EACjD,OAAO,MAAM;AACZ,UAAM,UAAU,QAAQ,gBAAgB;AACxC,SAAK,QAAQ,QAAQ,OAAO,KAAK;AACjC,SAAK,SAAS,QAAQ,UAAU,KAAK;AACrC,SAAK,YAAY,QAAQ,aAAa,KAAK;AAC3C,SAAK,WAAW,QAAQ,YAAY,KAAK;AACzC,SAAK,cAAc,QAAQ,eAAe,KAAK;AAC/C,cAAU;AAAA,MACR;AAAA,MACA,YAAY;AAAA,MACZ,OAAO;AAAA,IACT,CAAC;AAAA,EACH,CAAC;AAEH,UACG,QAAQ,KAAK,EACb,YAAY,sCAAsC,EAClD;AAAA,IACC,IAAI,wBAAO,uBAAuB,uBAAuB,EACtD,QAAQ,CAAC,SAAS,SAAS,QAAQ,QAAQ,SAAS,OAAO,CAAC,EAC5D,QAAQ,OAAO,EACf,IAAI,WAAW;AAAA,EACpB,EACC,OAAO,MAAM;AACZ,UAAM,UAAU,QAAQ,gBAAgB;AACxC,SAAK,QAAQ,QAAQ,OAAO,KAAK;AACjC,SAAK,SAAS,QAAQ,UAAU,KAAK;AACrC,SAAK,YAAY,QAAQ,aAAa,KAAK;AAC3C,SAAK,WAAW,QAAQ,YAAY,KAAK;AACzC,SAAK,cAAc,QAAQ,eAAe,KAAK;AAC/C,cAAU;AAAA,MACR;AAAA,MACA,YAAY;AAAA,MACZ,OAAO;AAAA,IACT,CAAC;AAAA,EACH,CAAC;AAEH,UACG,QAAQ,SAAS,EACjB,YAAY,4BAA4B,EACxC,eAAe,mBAAmB,yBAAyB,EAC3D,OAAO,mCAAmC,+BAA+B,EACzE;AAAA,IACC,IAAI,wBAAO,uBAAuB,uBAAuB,EACtD,QAAQ,CAAC,SAAS,SAAS,QAAQ,QAAQ,SAAS,OAAO,CAAC,EAC5D,QAAQ,OAAO,EACf,IAAI,WAAW;AAAA,EACpB,EACC,OAAO,IAAI,CAAC,EAAE,OAAO,MAAM;AAC1B,UAAM,UAAU,QAAQ,gBAAgB;AACxC,SAAK,QAAQ,QAAQ,OAAO,KAAK;AACjC,SAAK,SAAS,QAAQ,UAAU,KAAK;AACrC,SAAK,YAAY,QAAQ,aAAa,KAAK;AAC3C,SAAK,WAAW,QAAQ,YAAY,KAAK;AACzC,SAAK,cAAc,QAAQ,eAAe,KAAK;AAC/C,cAAU;AAAA,MACR;AAAA,MACA,YAAY;AAAA,MACZ,OAAO;AAAA,MACP,MAAM,QAAQ;AAAA,MACd,qBAAqB,QAAQ;AAAA,IAC/B,CAAC;AAAA,EACH,CAAC;AAEH,UACG,QAAQ,gBAAgB,EACxB,YAAY,kCAAkC,EAC9C;AAAA,IACC,IAAI,wBAAO,uBAAuB,uBAAuB,EACtD,QAAQ,CAAC,SAAS,SAAS,QAAQ,QAAQ,SAAS,OAAO,CAAC,EAC5D,QAAQ,OAAO,EACf,IAAI,WAAW;AAAA,EACpB,EACC,OAAO,MAAM;AACZ,UAAM,UAAU,QAAQ,gBAAgB;AACxC,qCAAiB,EAAE,QAAQ,MAAM,OAAO,QAAQ,SAAS,CAAC;AAC1D,UAAM,aAAS,gBAAI;AAEnB,UAAM,gBAAgB,YAAY;AAChC,iBAAW,UAAU,qBAAO,mBAAmB;AAC7C,eAAO,KAAK,yBAAyB,OAAO,KAAK,EAAE;AACnD,YAAI;AACF,gBAAM,OAAO,cAAc;AAC3B,iBAAO,KAAK,kCAAkC,OAAO,KAAK,EAAE;AAAA,QAC9D,SAAS,OAAO;AACd,iBAAO,MAAM,gCAAgC,OAAO,KAAK,KAAK,KAAK,EAAE;AAAA,QACvE;AAAA,MACF;AAAA,IACF;AAEA,kBAAc,EACX,MAAM,CAAC,UAAU;AAChB,aAAO,MAAM,gCAAgC,KAAK,EAAE;AACpD,cAAQ,KAAK,CAAC;AAAA,IAChB,CAAC,EACA,QAAQ,MAAM;AACb,cAAQ,KAAK,CAAC;AAAA,IAChB,CAAC;AAAA,EACL,CAAC;AAEH,UAAQ,MAAM;AAChB;","names":[]}
+{"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.21.0_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 logLevelOption = (defaultLevel: string) =>\n    new Option('--log-level <level>', 'Set the logging level')\n      .choices(['trace', 'debug', 'info', 'warn', 'error', 'fatal'])\n      .default(defaultLevel)\n      .env('LOG_LEVEL');\n\n  const program = new Command()\n    .name('agents')\n    .description('LiveKit Agents CLI')\n    .version(version)\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    .addOption(logLevelOption('info'))\n    .action((...[, command]) => {\n      const globalOptions = program.optsWithGlobals();\n      const commandOptions = command.opts();\n      opts.wsURL = globalOptions.url || opts.wsURL;\n      opts.apiKey = globalOptions.apiKey || opts.apiKey;\n      opts.apiSecret = globalOptions.apiSecret || opts.apiSecret;\n      opts.logLevel = commandOptions.logLevel;\n      opts.workerToken = globalOptions.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(logLevelOption('debug'))\n    .action((...[, command]) => {\n      const globalOptions = program.optsWithGlobals();\n      const commandOptions = command.opts();\n      opts.wsURL = globalOptions.url || opts.wsURL;\n      opts.apiKey = globalOptions.apiKey || opts.apiKey;\n      opts.apiSecret = globalOptions.apiSecret || opts.apiSecret;\n      opts.logLevel = commandOptions.logLevel;\n      opts.workerToken = globalOptions.workerToken || opts.workerToken;\n      process.env.LIVEKIT_DEV_MODE = '1';\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(logLevelOption('info'))\n    .action((...[, command]) => {\n      const globalOptions = program.optsWithGlobals();\n      const commandOptions = command.opts();\n      opts.wsURL = globalOptions.url || opts.wsURL;\n      opts.apiKey = globalOptions.apiKey || opts.apiKey;\n      opts.apiSecret = globalOptions.apiSecret || opts.apiSecret;\n      opts.logLevel = commandOptions.logLevel;\n      opts.workerToken = globalOptions.workerToken || opts.workerToken;\n      process.env.LIVEKIT_DEV_MODE = '1';\n      runServer({\n        opts,\n        production: false,\n        watch: false,\n        room: commandOptions.room,\n        participantIdentity: commandOptions.participantIdentity,\n      });\n    });\n\n  program\n    .command('download-files')\n    .description('Download plugin dependency files')\n    .addOption(logLevelOption('debug'))\n    .action((...[, command]) => {\n      const commandOptions = command.opts();\n      initializeLogger({ pretty: true, level: commandOptions.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":[]}