@livekit/agents 1.0.47 → 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/index.cjs

@@ -29,6 +29,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var index_exports = {};
 __export(index_exports, {
+  beta: () => beta,
   cli: () => cli,
   createTimedString: () => import_io.createTimedString,
   inference: () => inference,
@@ -44,6 +45,7 @@ __export(index_exports, {
   voice: () => voice
 });
 module.exports = __toCommonJS(index_exports);
+var beta = __toESM(require("./beta/index.cjs"), 1);
 var cli = __toESM(require("./cli.cjs"), 1);
 var inference = __toESM(require("./inference/index.cjs"), 1);
 var ipc = __toESM(require("./ipc/index.cjs"), 1);
@@ -72,6 +74,7 @@ var import_io = require("./voice/io.cjs");
 __reExport(index_exports, require("./worker.cjs"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  beta,
   cli,
   createTimedString,
   inference,

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\n\n/**\n * LiveKit Agents is a framework for building realtime programmable participants that run on\n * servers.\n *\n * @see {@link https://docs.livekit.io/agents/overview | LiveKit Agents documentation}\n * @packageDocumentation\n */\nimport * as cli from './cli.js';\nimport * as inference from './inference/index.js';\nimport * as ipc from './ipc/index.js';\nimport * as llm from './llm/index.js';\nimport * as metrics from './metrics/index.js';\nimport * as stream from './stream/index.js';\nimport * as stt from './stt/index.js';\nimport * as telemetry from './telemetry/index.js';\nimport * as tokenize from './tokenize/index.js';\nimport * as tts from './tts/index.js';\nimport * as voice from './voice/index.js';\n\nexport * from './_exceptions.js';\nexport * from './audio.js';\nexport * from './connection_pool.js';\nexport * from './generator.js';\nexport * from './inference_runner.js';\nexport * from './job.js';\nexport * from './log.js';\nexport * from './plugin.js';\nexport * from './transcription.js';\nexport * from './types.js';\nexport * from './utils.js';\nexport * from './vad.js';\nexport * from './version.js';\nexport { createTimedString, isTimedString, type TimedString } from './voice/io.js';\nexport * from './worker.js';\n\nexport { cli, inference, ipc, llm, metrics, stream, stt, telemetry, tokenize, tts, voice };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAWA,UAAqB;AACrB,gBAA2B;AAC3B,UAAqB;AACrB,UAAqB;AACrB,cAAyB;AACzB,aAAwB;AACxB,UAAqB;AACrB,gBAA2B;AAC3B,eAA0B;AAC1B,UAAqB;AACrB,YAAuB;AAEvB,0BAAc,6BAvBd;AAwBA,0BAAc,uBAxBd;AAyBA,0BAAc,iCAzBd;AA0BA,0BAAc,2BA1Bd;AA2BA,0BAAc,kCA3Bd;AA4BA,0BAAc,qBA5Bd;AA6BA,0BAAc,qBA7Bd;AA8BA,0BAAc,wBA9Bd;AA+BA,0BAAc,+BA/Bd;AAgCA,0BAAc,uBAhCd;AAiCA,0BAAc,uBAjCd;AAkCA,0BAAc,qBAlCd;AAmCA,0BAAc,yBAnCd;AAoCA,gBAAmE;AACnE,0BAAc,wBArCd;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\n\n/**\n * LiveKit Agents is a framework for building realtime programmable participants that run on\n * servers.\n *\n * @see {@link https://docs.livekit.io/agents/overview | LiveKit Agents documentation}\n * @packageDocumentation\n */\nimport * as beta from './beta/index.js';\nimport * as cli from './cli.js';\nimport * as inference from './inference/index.js';\nimport * as ipc from './ipc/index.js';\nimport * as llm from './llm/index.js';\nimport * as metrics from './metrics/index.js';\nimport * as stream from './stream/index.js';\nimport * as stt from './stt/index.js';\nimport * as telemetry from './telemetry/index.js';\nimport * as tokenize from './tokenize/index.js';\nimport * as tts from './tts/index.js';\nimport * as voice from './voice/index.js';\n\nexport * from './_exceptions.js';\nexport * from './audio.js';\nexport * from './connection_pool.js';\nexport * from './generator.js';\nexport * from './inference_runner.js';\nexport * from './job.js';\nexport * from './log.js';\nexport * from './plugin.js';\nexport * from './transcription.js';\nexport * from './types.js';\nexport * from './utils.js';\nexport * from './vad.js';\nexport * from './version.js';\nexport { createTimedString, isTimedString, type TimedString } from './voice/io.js';\nexport * from './worker.js';\n\nexport { beta, cli, inference, ipc, llm, metrics, stream, stt, telemetry, tokenize, tts, voice };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAWA,WAAsB;AACtB,UAAqB;AACrB,gBAA2B;AAC3B,UAAqB;AACrB,UAAqB;AACrB,cAAyB;AACzB,aAAwB;AACxB,UAAqB;AACrB,gBAA2B;AAC3B,eAA0B;AAC1B,UAAqB;AACrB,YAAuB;AAEvB,0BAAc,6BAxBd;AAyBA,0BAAc,uBAzBd;AA0BA,0BAAc,iCA1Bd;AA2BA,0BAAc,2BA3Bd;AA4BA,0BAAc,kCA5Bd;AA6BA,0BAAc,qBA7Bd;AA8BA,0BAAc,qBA9Bd;AA+BA,0BAAc,wBA/Bd;AAgCA,0BAAc,+BAhCd;AAiCA,0BAAc,uBAjCd;AAkCA,0BAAc,uBAlCd;AAmCA,0BAAc,qBAnCd;AAoCA,0BAAc,yBApCd;AAqCA,gBAAmE;AACnE,0BAAc,wBAtCd;","names":[]}

package/dist/index.d.cts

@@ -5,6 +5,7 @@
  * @see {@link https://docs.livekit.io/agents/overview | LiveKit Agents documentation}
  * @packageDocumentation
  */
+import * as beta from './beta/index.js';
 import * as cli from './cli.js';
 import * as inference from './inference/index.js';
 import * as ipc from './ipc/index.js';
@@ -31,5 +32,5 @@ export * from './vad.js';
 export * from './version.js';
 export { createTimedString, isTimedString, type TimedString } from './voice/io.js';
 export * from './worker.js';
-export { cli, inference, ipc, llm, metrics, stream, stt, telemetry, tokenize, tts, voice };
+export { beta, cli, inference, ipc, llm, metrics, stream, stt, telemetry, tokenize, tts, voice };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts

@@ -5,6 +5,7 @@
  * @see {@link https://docs.livekit.io/agents/overview | LiveKit Agents documentation}
  * @packageDocumentation
  */
+import * as beta from './beta/index.js';
 import * as cli from './cli.js';
 import * as inference from './inference/index.js';
 import * as ipc from './ipc/index.js';
@@ -31,5 +32,5 @@ export * from './vad.js';
 export * from './version.js';
 export { createTimedString, isTimedString, type TimedString } from './voice/io.js';
 export * from './worker.js';
-export { cli, inference, ipc, llm, metrics, stream, stt, telemetry, tokenize, tts, voice };
+export { beta, cli, inference, ipc, llm, metrics, stream, stt, telemetry, tokenize, tts, voice };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAE1C,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AACnF,cAAc,aAAa,CAAC;AAE5B,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAE1C,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AACnF,cAAc,aAAa,CAAC;AAE5B,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC"}

package/dist/index.js

@@ -1,3 +1,4 @@
+import * as beta from "./beta/index.js";
 import * as cli from "./cli.js";
 import * as inference from "./inference/index.js";
 import * as ipc from "./ipc/index.js";
@@ -25,6 +26,7 @@ export * from "./version.js";
 import { createTimedString, isTimedString } from "./voice/io.js";
 export * from "./worker.js";
 export {
+  beta,
   cli,
   createTimedString,
   inference,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\n\n/**\n * LiveKit Agents is a framework for building realtime programmable participants that run on\n * servers.\n *\n * @see {@link https://docs.livekit.io/agents/overview | LiveKit Agents documentation}\n * @packageDocumentation\n */\nimport * as cli from './cli.js';\nimport * as inference from './inference/index.js';\nimport * as ipc from './ipc/index.js';\nimport * as llm from './llm/index.js';\nimport * as metrics from './metrics/index.js';\nimport * as stream from './stream/index.js';\nimport * as stt from './stt/index.js';\nimport * as telemetry from './telemetry/index.js';\nimport * as tokenize from './tokenize/index.js';\nimport * as tts from './tts/index.js';\nimport * as voice from './voice/index.js';\n\nexport * from './_exceptions.js';\nexport * from './audio.js';\nexport * from './connection_pool.js';\nexport * from './generator.js';\nexport * from './inference_runner.js';\nexport * from './job.js';\nexport * from './log.js';\nexport * from './plugin.js';\nexport * from './transcription.js';\nexport * from './types.js';\nexport * from './utils.js';\nexport * from './vad.js';\nexport * from './version.js';\nexport { createTimedString, isTimedString, type TimedString } from './voice/io.js';\nexport * from './worker.js';\n\nexport { cli, inference, ipc, llm, metrics, stream, stt, telemetry, tokenize, tts, voice };\n"],"mappings":"AAWA,YAAY,SAAS;AACrB,YAAY,eAAe;AAC3B,YAAY,SAAS;AACrB,YAAY,SAAS;AACrB,YAAY,aAAa;AACzB,YAAY,YAAY;AACxB,YAAY,SAAS;AACrB,YAAY,eAAe;AAC3B,YAAY,cAAc;AAC1B,YAAY,SAAS;AACrB,YAAY,WAAW;AAEvB,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,SAAS,mBAAmB,qBAAuC;AACnE,cAAc;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\n\n/**\n * LiveKit Agents is a framework for building realtime programmable participants that run on\n * servers.\n *\n * @see {@link https://docs.livekit.io/agents/overview | LiveKit Agents documentation}\n * @packageDocumentation\n */\nimport * as beta from './beta/index.js';\nimport * as cli from './cli.js';\nimport * as inference from './inference/index.js';\nimport * as ipc from './ipc/index.js';\nimport * as llm from './llm/index.js';\nimport * as metrics from './metrics/index.js';\nimport * as stream from './stream/index.js';\nimport * as stt from './stt/index.js';\nimport * as telemetry from './telemetry/index.js';\nimport * as tokenize from './tokenize/index.js';\nimport * as tts from './tts/index.js';\nimport * as voice from './voice/index.js';\n\nexport * from './_exceptions.js';\nexport * from './audio.js';\nexport * from './connection_pool.js';\nexport * from './generator.js';\nexport * from './inference_runner.js';\nexport * from './job.js';\nexport * from './log.js';\nexport * from './plugin.js';\nexport * from './transcription.js';\nexport * from './types.js';\nexport * from './utils.js';\nexport * from './vad.js';\nexport * from './version.js';\nexport { createTimedString, isTimedString, type TimedString } from './voice/io.js';\nexport * from './worker.js';\n\nexport { beta, cli, inference, ipc, llm, metrics, stream, stt, telemetry, tokenize, tts, voice };\n"],"mappings":"AAWA,YAAY,UAAU;AACtB,YAAY,SAAS;AACrB,YAAY,eAAe;AAC3B,YAAY,SAAS;AACrB,YAAY,SAAS;AACrB,YAAY,aAAa;AACzB,YAAY,YAAY;AACxB,YAAY,SAAS;AACrB,YAAY,eAAe;AAC3B,YAAY,cAAc;AAC1B,YAAY,SAAS;AACrB,YAAY,WAAW;AAEvB,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,SAAS,mBAAmB,qBAAuC;AACnE,cAAc;","names":[]}