@livekit/agents 1.0.46 → 1.0.48

package/dist/beta/index.cjs

@@ -0,0 +1,29 @@
+"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 beta_exports = {};
+__export(beta_exports, {
+  TaskGroup: () => import_workflows.TaskGroup
+});
+module.exports = __toCommonJS(beta_exports);
+var import_workflows = require("./workflows/index.cjs");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  TaskGroup
+});
+//# sourceMappingURL=index.cjs.map

package/dist/beta/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/beta/index.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2026 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nexport {\n  TaskGroup,\n  type TaskCompletedEvent,\n  type TaskGroupOptions,\n  type TaskGroupResult,\n} from './workflows/index.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,uBAKO;","names":[]}

package/dist/beta/index.d.cts

@@ -0,0 +1,2 @@
+export { TaskGroup, type TaskCompletedEvent, type TaskGroupOptions, type TaskGroupResult, } from './workflows/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/beta/index.d.ts

@@ -0,0 +1,2 @@
+export { TaskGroup, type TaskCompletedEvent, type TaskGroupOptions, type TaskGroupResult, } from './workflows/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/beta/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/beta/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,SAAS,EACT,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,sBAAsB,CAAC"}

package/dist/beta/index.js

@@ -0,0 +1,7 @@
+import {
+  TaskGroup
+} from "./workflows/index.js";
+export {
+  TaskGroup
+};
+//# sourceMappingURL=index.js.map

package/dist/beta/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/beta/index.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2026 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nexport {\n  TaskGroup,\n  type TaskCompletedEvent,\n  type TaskGroupOptions,\n  type TaskGroupResult,\n} from './workflows/index.js';\n"],"mappings":"AAGA;AAAA,EACE;AAAA,OAIK;","names":[]}

package/dist/beta/workflows/index.cjs

@@ -0,0 +1,29 @@
+"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 workflows_exports = {};
+__export(workflows_exports, {
+  TaskGroup: () => import_task_group.TaskGroup
+});
+module.exports = __toCommonJS(workflows_exports);
+var import_task_group = require("./task_group.cjs");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  TaskGroup
+});
+//# sourceMappingURL=index.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/beta/workflows/index.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2026 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nexport {\n  TaskGroup,\n  type TaskCompletedEvent,\n  type TaskGroupOptions,\n  type TaskGroupResult,\n} from './task_group.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,wBAKO;","names":[]}

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

@@ -0,0 +1,2 @@
+export { TaskGroup, type TaskCompletedEvent, type TaskGroupOptions, type TaskGroupResult, } from './task_group.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,2 @@
+export { TaskGroup, type TaskCompletedEvent, type TaskGroupOptions, type TaskGroupResult, } from './task_group.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/beta/workflows/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,SAAS,EACT,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,iBAAiB,CAAC"}

package/dist/beta/workflows/index.js

@@ -0,0 +1,7 @@
+import {
+  TaskGroup
+} from "./task_group.js";
+export {
+  TaskGroup
+};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/beta/workflows/index.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2026 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nexport {\n  TaskGroup,\n  type TaskCompletedEvent,\n  type TaskGroupOptions,\n  type TaskGroupResult,\n} from './task_group.js';\n"],"mappings":"AAGA;AAAA,EACE;AAAA,OAIK;","names":[]}

package/dist/beta/workflows/task_group.cjs

@@ -0,0 +1,162 @@
+"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();
+        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: true,
+          excludeHandoff: true,
+          excludeEmptyMessage: true,
+          excludeFunctionCall: true
+        });
+        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        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        // TODO(parity): Add excludeConfigUpdate when AgentConfigUpdate is ported\n        const ctxToSummarize = this._chatCtx.copy({\n          excludeInstructions: true,\n          excludeHandoff: true,\n          excludeEmptyMessage: true,\n          excludeFunctionCall: true,\n        });\n\n        const summarizedChatCtx = await ctxToSummarize._summarize(sessionLlm, {\n          keepLastTurns: 0,\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;IAgF9B,OAAO,CAAC,mBAAmB;CAkD5B"}

package/dist/beta/workflows/task_group.js

@@ -0,0 +1,138 @@
+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();
+        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: true,
+          excludeHandoff: true,
+          excludeEmptyMessage: true,
+          excludeFunctionCall: true
+        });
+        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        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        // TODO(parity): Add excludeConfigUpdate when AgentConfigUpdate is ported\n        const ctxToSummarize = this._chatCtx.copy({\n          excludeInstructions: true,\n          excludeHandoff: true,\n          excludeEmptyMessage: true,\n          excludeFunctionCall: true,\n        });\n\n        const summarizedChatCtx = await ctxToSummarize._summarize(sessionLlm, {\n          keepLastTurns: 0,\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

@@ -69,9 +69,8 @@ const runServer = async (args) => {
   }
 };
 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,28 +92,27 @@ 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;
+  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((...[, command]) => {
+  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 || globalOptions.logLevel || opts.logLevel;
+    opts.logLevel = commandOptions.logLevel;
     opts.workerToken = globalOptions.workerToken || opts.workerToken;
     runServer({
       opts,
@@ -122,15 +120,13 @@ const runApp = (opts) => {
       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]) => {
+  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 || globalOptions.logLevel || opts.logLevel;
+    opts.logLevel = commandOptions.logLevel;
     opts.workerToken = globalOptions.workerToken || opts.workerToken;
     runServer({
       opts,
@@ -140,9 +136,7 @@ const runApp = (opts) => {
       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((...[, command]) => {
+  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)();