@livekit/agents 1.0.47 → 1.1.0-dev.0

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":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,iBAAkB;AAElB,iBAA+C;AAC/C,mBAA0B;AAkB1B,MAAM,wBAAwB,qBAAU;AAAA,EAC7B;AAAA,EAET,YAAY,eAAyB;AACnC,UAAM,cAAc;AACpB,SAAK,gBAAgB;AAAA,EACvB;AACF;AASO,MAAM,kBAAkB,uBAA2B;AAAA,EAChD;AAAA,EACA;AAAA,EACA,gBAAgB,oBAAI,IAAY;AAAA,EAChC,uBAAuB,oBAAI,IAAyB;AAAA,EACpD;AAAA,EACA;AAAA,EAER,YAAY,UAA4B,CAAC,GAAG;AAC1C,UAAM,EAAE,mBAAmB,MAAM,mBAAmB,OAAO,SAAS,gBAAgB,IAAI;AAExF,UAAM,EAAE,cAAc,WAAW,QAAQ,CAAC;AAE1C,SAAK,oBAAoB;AACzB,SAAK,oBAAoB;AACzB,SAAK,yBAAyB;AAAA,EAChC;AAAA,EAEA,IAAI,MAAuB,EAAE,IAAI,YAAY,GAA8C;AACzF,SAAK,qBAAqB,IAAI,IAAI,EAAE,aAAa,MAAM,IAAI,YAAY,CAAC;AACxE,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,UAAyB;AAC7B,UAAM,YAAY,CAAC,GAAG,KAAK,qBAAqB,KAAK,CAAC;AACtD,UAAM,cAAuC,CAAC;AAE9C,WAAO,UAAU,SAAS,GAAG;AAC3B,YAAM,SAAS,UAAU,MAAM;AAC/B,YAAM,cAAc,KAAK,qBAAqB,IAAI,MAAM;AAExD,WAAK,eAAe,YAAY,YAAY;AAE5C,YAAM,gBAAgB,KAAK,SAAS,KAAK;AACzC,YAAM,KAAK,aAAa,cAAc,aAAa;AAEnD,YAAM,iBAAiB,KAAK,oBAAoB,MAAM;AACtD,UAAI,gBAAgB;AAClB,cAAM,KAAK,aAAa,YAAY;AAAA,UAClC,GAAG,KAAK,aAAa;AAAA,UACrB,cAAc;AAAA,QAChB,CAAC;AAAA,MACH;AAEA,UAAI;AACF,aAAK,cAAc,IAAI,MAAM;AAC7B,cAAM,MAAM,MAAM,KAAK,aAAa,IAAI;AACxC,oBAAY,MAAM,IAAI;AAEtB,YAAI,KAAK,wBAAwB;AAC/B,gBAAM,KAAK,uBAAuB;AAAA,YAChC,WAAW,KAAK;AAAA,YAChB;AAAA,YACA,QAAQ;AAAA,UACV,CAAC;AAAA,QACH;AAAA,MACF,SAAS,GAAG;AACV,YAAI,aAAa,iBAAiB;AAChC,oBAAU,QAAQ,MAAM;AACxB,mBAAS,IAAI,EAAE,cAAc,SAAS,GAAG,KAAK,GAAG,KAAK;AACpD,sBAAU,QAAQ,EAAE,cAAc,CAAC,CAAE;AAAA,UACvC;AACA;AAAA,QACF;AAEA,YAAI,KAAK,mBAAmB;AAC1B,sBAAY,MAAM,IAAI;AACtB;AAAA,QACF,OAAO;AACL,eAAK,SAAS,aAAa,QAAQ,IAAI,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC;AAC3D;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAEA,QAAI;AACF,UAAI,KAAK,mBAAmB;AAC1B,cAAM,aAAa,KAAK,QAAQ;AAChC,YAAI,EAAE,sBAAsB,iBAAM;AAChC,gBAAM,IAAI,MAAM,yDAAyD;AAAA,QAC3E;AAGA,cAAM,iBAAiB,KAAK,SAAS,KAAK;AAAA,UACxC,qBAAqB;AAAA,UACrB,gBAAgB;AAAA,UAChB,qBAAqB;AAAA,UACrB,qBAAqB;AAAA,QACvB,CAAC;AAED,cAAM,oBAAoB,MAAM,eAAe,WAAW,YAAY;AAAA,UACpE,eAAe;AAAA,QACjB,CAAC;AACD,cAAM,KAAK,cAAc,iBAAiB;AAAA,MAC5C;AAAA,IACF,SAAS,GAAG;AACV,WAAK,SAAS,IAAI,MAAM,qCAAqC,CAAC,EAAE,CAAC;AACjE;AAAA,IACF;AAEA,SAAK,SAAS,EAAE,YAAY,CAAC;AAAA,EAC/B;AAAA,EAEQ,oBAAoB,cAAsB;AAChD,QAAI,KAAK,cAAc,SAAS,GAAG;AACjC,aAAO;AAAA,IACT;AAEA,UAAM,oBAAoB,IAAI,IAAI,KAAK,aAAa;AACpD,sBAAkB,OAAO,YAAY;AAErC,QAAI,kBAAkB,SAAS,GAAG;AAChC,aAAO;AAAA,IACT;AAEA,UAAM,WAAmC,CAAC;AAC1C,eAAW,CAAC,IAAI,IAAI,KAAK,KAAK,sBAAsB;AAClD,UAAI,kBAAkB,IAAI,EAAE,GAAG;AAC7B,iBAAS,EAAE,IAAI,KAAK;AAAA,MACtB;AAAA,IACF;AAEA,UAAM,eAAe,CAAC,GAAG,iBAAiB;AAE1C,UAAM,cACJ,ogBAGuE,KAAK,UAAU,QAAQ,CAAC;AAEjG,UAAM,cAAc,KAAK;AACzB,UAAM,sBAAsB,KAAK;AACjC,UAAM,eAAe,KAAK;AAE1B,eAAO,iBAAK;AAAA,MACV;AAAA,MACA,OAAO,oBAAS;AAAA,MAChB,YAAY,aAAE,OAAO;AAAA,QACnB,UAAU,aAAE,MAAM,aAAE,KAAK,YAAY,CAAC,EAAE,SAAS,gCAAgC;AAAA,MACnF,CAAC;AAAA,MACD,SAAS,OAAO,EAAE,SAAS,MAA8B;AACvD,mBAAW,OAAO,UAAU;AAC1B,cAAI,CAAC,oBAAoB,IAAI,GAAG,KAAK,CAAC,aAAa,IAAI,GAAG,GAAG;AAC3D,kBAAM,IAAI,qBAAU,sCAAsC,GAAG,EAAE;AAAA,UACjE;AAAA,QACF;AAEA,YAAI,eAAe,CAAC,YAAY,MAAM;AACpC,sBAAY,SAAS,IAAI,gBAAgB,QAAQ,CAAC;AAAA,QACpD;AAAA,MACF;AAAA,IACF,CAAC;AAAA,EACH;AACF;","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":"AAGA,SAAS,SAAS;AAElB,SAAS,KAAK,WAAW,UAAU,YAAY;AAC/C,SAAS,iBAAiB;AAkB1B,MAAM,wBAAwB,UAAU;AAAA,EAC7B;AAAA,EAET,YAAY,eAAyB;AACnC,UAAM,cAAc;AACpB,SAAK,gBAAgB;AAAA,EACvB;AACF;AASO,MAAM,kBAAkB,UAA2B;AAAA,EAChD;AAAA,EACA;AAAA,EACA,gBAAgB,oBAAI,IAAY;AAAA,EAChC,uBAAuB,oBAAI,IAAyB;AAAA,EACpD;AAAA,EACA;AAAA,EAER,YAAY,UAA4B,CAAC,GAAG;AAC1C,UAAM,EAAE,mBAAmB,MAAM,mBAAmB,OAAO,SAAS,gBAAgB,IAAI;AAExF,UAAM,EAAE,cAAc,WAAW,QAAQ,CAAC;AAE1C,SAAK,oBAAoB;AACzB,SAAK,oBAAoB;AACzB,SAAK,yBAAyB;AAAA,EAChC;AAAA,EAEA,IAAI,MAAuB,EAAE,IAAI,YAAY,GAA8C;AACzF,SAAK,qBAAqB,IAAI,IAAI,EAAE,aAAa,MAAM,IAAI,YAAY,CAAC;AACxE,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,UAAyB;AAC7B,UAAM,YAAY,CAAC,GAAG,KAAK,qBAAqB,KAAK,CAAC;AACtD,UAAM,cAAuC,CAAC;AAE9C,WAAO,UAAU,SAAS,GAAG;AAC3B,YAAM,SAAS,UAAU,MAAM;AAC/B,YAAM,cAAc,KAAK,qBAAqB,IAAI,MAAM;AAExD,WAAK,eAAe,YAAY,YAAY;AAE5C,YAAM,gBAAgB,KAAK,SAAS,KAAK;AACzC,YAAM,KAAK,aAAa,cAAc,aAAa;AAEnD,YAAM,iBAAiB,KAAK,oBAAoB,MAAM;AACtD,UAAI,gBAAgB;AAClB,cAAM,KAAK,aAAa,YAAY;AAAA,UAClC,GAAG,KAAK,aAAa;AAAA,UACrB,cAAc;AAAA,QAChB,CAAC;AAAA,MACH;AAEA,UAAI;AACF,aAAK,cAAc,IAAI,MAAM;AAC7B,cAAM,MAAM,MAAM,KAAK,aAAa,IAAI;AACxC,oBAAY,MAAM,IAAI;AAEtB,YAAI,KAAK,wBAAwB;AAC/B,gBAAM,KAAK,uBAAuB;AAAA,YAChC,WAAW,KAAK;AAAA,YAChB;AAAA,YACA,QAAQ;AAAA,UACV,CAAC;AAAA,QACH;AAAA,MACF,SAAS,GAAG;AACV,YAAI,aAAa,iBAAiB;AAChC,oBAAU,QAAQ,MAAM;AACxB,mBAAS,IAAI,EAAE,cAAc,SAAS,GAAG,KAAK,GAAG,KAAK;AACpD,sBAAU,QAAQ,EAAE,cAAc,CAAC,CAAE;AAAA,UACvC;AACA;AAAA,QACF;AAEA,YAAI,KAAK,mBAAmB;AAC1B,sBAAY,MAAM,IAAI;AACtB;AAAA,QACF,OAAO;AACL,eAAK,SAAS,aAAa,QAAQ,IAAI,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC;AAC3D;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAEA,QAAI;AACF,UAAI,KAAK,mBAAmB;AAC1B,cAAM,aAAa,KAAK,QAAQ;AAChC,YAAI,EAAE,sBAAsB,MAAM;AAChC,gBAAM,IAAI,MAAM,yDAAyD;AAAA,QAC3E;AAGA,cAAM,iBAAiB,KAAK,SAAS,KAAK;AAAA,UACxC,qBAAqB;AAAA,UACrB,gBAAgB;AAAA,UAChB,qBAAqB;AAAA,UACrB,qBAAqB;AAAA,QACvB,CAAC;AAED,cAAM,oBAAoB,MAAM,eAAe,WAAW,YAAY;AAAA,UACpE,eAAe;AAAA,QACjB,CAAC;AACD,cAAM,KAAK,cAAc,iBAAiB;AAAA,MAC5C;AAAA,IACF,SAAS,GAAG;AACV,WAAK,SAAS,IAAI,MAAM,qCAAqC,CAAC,EAAE,CAAC;AACjE;AAAA,IACF;AAEA,SAAK,SAAS,EAAE,YAAY,CAAC;AAAA,EAC/B;AAAA,EAEQ,oBAAoB,cAAsB;AAChD,QAAI,KAAK,cAAc,SAAS,GAAG;AACjC,aAAO;AAAA,IACT;AAEA,UAAM,oBAAoB,IAAI,IAAI,KAAK,aAAa;AACpD,sBAAkB,OAAO,YAAY;AAErC,QAAI,kBAAkB,SAAS,GAAG;AAChC,aAAO;AAAA,IACT;AAEA,UAAM,WAAmC,CAAC;AAC1C,eAAW,CAAC,IAAI,IAAI,KAAK,KAAK,sBAAsB;AAClD,UAAI,kBAAkB,IAAI,EAAE,GAAG;AAC7B,iBAAS,EAAE,IAAI,KAAK;AAAA,MACtB;AAAA,IACF;AAEA,UAAM,eAAe,CAAC,GAAG,iBAAiB;AAE1C,UAAM,cACJ,ogBAGuE,KAAK,UAAU,QAAQ,CAAC;AAEjG,UAAM,cAAc,KAAK;AACzB,UAAM,sBAAsB,KAAK;AACjC,UAAM,eAAe,KAAK;AAE1B,WAAO,KAAK;AAAA,MACV;AAAA,MACA,OAAO,SAAS;AAAA,MAChB,YAAY,EAAE,OAAO;AAAA,QACnB,UAAU,EAAE,MAAM,EAAE,KAAK,YAAY,CAAC,EAAE,SAAS,gCAAgC;AAAA,MACnF,CAAC;AAAA,MACD,SAAS,OAAO,EAAE,SAAS,MAA8B;AACvD,mBAAW,OAAO,UAAU;AAC1B,cAAI,CAAC,oBAAoB,IAAI,GAAG,KAAK,CAAC,aAAa,IAAI,GAAG,GAAG;AAC3D,kBAAM,IAAI,UAAU,sCAAsC,GAAG,EAAE;AAAA,UACjE;AAAA,QACF;AAEA,YAAI,eAAe,CAAC,YAAY,MAAM;AACpC,sBAAY,SAAS,IAAI,gBAAgB,QAAQ,CAAC;AAAA,QACpD;AAAA,MACF;AAAA,IACF,CAAC;AAAA,EACH;AACF;","names":[]}

package/dist/constants.cjs

@@ -18,11 +18,20 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var constants_exports = {};
 __export(constants_exports, {
+  ATTRIBUTE_AGENT_NAME: () => ATTRIBUTE_AGENT_NAME,
+  ATTRIBUTE_AGENT_STATE: () => ATTRIBUTE_AGENT_STATE,
   ATTRIBUTE_PUBLISH_ON_BEHALF: () => ATTRIBUTE_PUBLISH_ON_BEHALF,
   ATTRIBUTE_TRANSCRIPTION_FINAL: () => ATTRIBUTE_TRANSCRIPTION_FINAL,
   ATTRIBUTE_TRANSCRIPTION_SEGMENT_ID: () => ATTRIBUTE_TRANSCRIPTION_SEGMENT_ID,
   ATTRIBUTE_TRANSCRIPTION_TRACK_ID: () => ATTRIBUTE_TRANSCRIPTION_TRACK_ID,
+  RPC_GET_AGENT_INFO: () => RPC_GET_AGENT_INFO,
+  RPC_GET_CHAT_HISTORY: () => RPC_GET_CHAT_HISTORY,
+  RPC_GET_SESSION_STATE: () => RPC_GET_SESSION_STATE,
+  RPC_SEND_MESSAGE: () => RPC_SEND_MESSAGE,
+  TOPIC_AGENT_REQUEST: () => TOPIC_AGENT_REQUEST,
+  TOPIC_AGENT_RESPONSE: () => TOPIC_AGENT_RESPONSE,
   TOPIC_CHAT: () => TOPIC_CHAT,
+  TOPIC_CLIENT_EVENTS: () => TOPIC_CLIENT_EVENTS,
   TOPIC_TRANSCRIPTION: () => TOPIC_TRANSCRIPTION
 });
 module.exports = __toCommonJS(constants_exports);
@@ -32,13 +41,31 @@ const TOPIC_TRANSCRIPTION = "lk.transcription";
 const ATTRIBUTE_TRANSCRIPTION_SEGMENT_ID = "lk.segment_id";
 const ATTRIBUTE_PUBLISH_ON_BEHALF = "lk.publish_on_behalf";
 const TOPIC_CHAT = "lk.chat";
+const ATTRIBUTE_AGENT_STATE = "lk.agent.state";
+const ATTRIBUTE_AGENT_NAME = "lk.agent.name";
+const TOPIC_CLIENT_EVENTS = "lk.agent.events";
+const RPC_GET_SESSION_STATE = "lk.agent.get_session_state";
+const RPC_GET_CHAT_HISTORY = "lk.agent.get_chat_history";
+const RPC_GET_AGENT_INFO = "lk.agent.get_agent_info";
+const RPC_SEND_MESSAGE = "lk.agent.send_message";
+const TOPIC_AGENT_REQUEST = "lk.agent.request";
+const TOPIC_AGENT_RESPONSE = "lk.agent.response";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  ATTRIBUTE_AGENT_NAME,
+  ATTRIBUTE_AGENT_STATE,
   ATTRIBUTE_PUBLISH_ON_BEHALF,
   ATTRIBUTE_TRANSCRIPTION_FINAL,
   ATTRIBUTE_TRANSCRIPTION_SEGMENT_ID,
   ATTRIBUTE_TRANSCRIPTION_TRACK_ID,
+  RPC_GET_AGENT_INFO,
+  RPC_GET_CHAT_HISTORY,
+  RPC_GET_SESSION_STATE,
+  RPC_SEND_MESSAGE,
+  TOPIC_AGENT_REQUEST,
+  TOPIC_AGENT_RESPONSE,
   TOPIC_CHAT,
+  TOPIC_CLIENT_EVENTS,
   TOPIC_TRANSCRIPTION
 });
 //# sourceMappingURL=constants.cjs.map

package/dist/constants.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/constants.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nexport const ATTRIBUTE_TRANSCRIPTION_TRACK_ID = 'lk.transcribed_track_id';\nexport const ATTRIBUTE_TRANSCRIPTION_FINAL = 'lk.transcription_final';\nexport const TOPIC_TRANSCRIPTION = 'lk.transcription';\nexport const ATTRIBUTE_TRANSCRIPTION_SEGMENT_ID = 'lk.segment_id';\nexport const ATTRIBUTE_PUBLISH_ON_BEHALF = 'lk.publish_on_behalf';\nexport const TOPIC_CHAT = 'lk.chat';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAGO,MAAM,mCAAmC;AACzC,MAAM,gCAAgC;AACtC,MAAM,sBAAsB;AAC5B,MAAM,qCAAqC;AAC3C,MAAM,8BAA8B;AACpC,MAAM,aAAa;","names":[]}
+{"version":3,"sources":["../src/constants.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nexport const ATTRIBUTE_TRANSCRIPTION_TRACK_ID = 'lk.transcribed_track_id';\nexport const ATTRIBUTE_TRANSCRIPTION_FINAL = 'lk.transcription_final';\nexport const TOPIC_TRANSCRIPTION = 'lk.transcription';\nexport const ATTRIBUTE_TRANSCRIPTION_SEGMENT_ID = 'lk.segment_id';\nexport const ATTRIBUTE_PUBLISH_ON_BEHALF = 'lk.publish_on_behalf';\nexport const TOPIC_CHAT = 'lk.chat';\n\nexport const ATTRIBUTE_AGENT_STATE = 'lk.agent.state';\nexport const ATTRIBUTE_AGENT_NAME = 'lk.agent.name';\n\n// TODO(eval): export const ATTRIBUTE_SIMULATOR = 'lk.simulator';\n\nexport const TOPIC_CLIENT_EVENTS = 'lk.agent.events';\nexport const RPC_GET_SESSION_STATE = 'lk.agent.get_session_state';\nexport const RPC_GET_CHAT_HISTORY = 'lk.agent.get_chat_history';\nexport const RPC_GET_AGENT_INFO = 'lk.agent.get_agent_info';\nexport const RPC_SEND_MESSAGE = 'lk.agent.send_message';\nexport const TOPIC_AGENT_REQUEST = 'lk.agent.request';\nexport const TOPIC_AGENT_RESPONSE = 'lk.agent.response';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAGO,MAAM,mCAAmC;AACzC,MAAM,gCAAgC;AACtC,MAAM,sBAAsB;AAC5B,MAAM,qCAAqC;AAC3C,MAAM,8BAA8B;AACpC,MAAM,aAAa;AAEnB,MAAM,wBAAwB;AAC9B,MAAM,uBAAuB;AAI7B,MAAM,sBAAsB;AAC5B,MAAM,wBAAwB;AAC9B,MAAM,uBAAuB;AAC7B,MAAM,qBAAqB;AAC3B,MAAM,mBAAmB;AACzB,MAAM,sBAAsB;AAC5B,MAAM,uBAAuB;","names":[]}

package/dist/constants.d.cts

@@ -4,4 +4,13 @@ export declare const TOPIC_TRANSCRIPTION = "lk.transcription";
 export declare const ATTRIBUTE_TRANSCRIPTION_SEGMENT_ID = "lk.segment_id";
 export declare const ATTRIBUTE_PUBLISH_ON_BEHALF = "lk.publish_on_behalf";
 export declare const TOPIC_CHAT = "lk.chat";
+export declare const ATTRIBUTE_AGENT_STATE = "lk.agent.state";
+export declare const ATTRIBUTE_AGENT_NAME = "lk.agent.name";
+export declare const TOPIC_CLIENT_EVENTS = "lk.agent.events";
+export declare const RPC_GET_SESSION_STATE = "lk.agent.get_session_state";
+export declare const RPC_GET_CHAT_HISTORY = "lk.agent.get_chat_history";
+export declare const RPC_GET_AGENT_INFO = "lk.agent.get_agent_info";
+export declare const RPC_SEND_MESSAGE = "lk.agent.send_message";
+export declare const TOPIC_AGENT_REQUEST = "lk.agent.request";
+export declare const TOPIC_AGENT_RESPONSE = "lk.agent.response";
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts

@@ -4,4 +4,13 @@ export declare const TOPIC_TRANSCRIPTION = "lk.transcription";
 export declare const ATTRIBUTE_TRANSCRIPTION_SEGMENT_ID = "lk.segment_id";
 export declare const ATTRIBUTE_PUBLISH_ON_BEHALF = "lk.publish_on_behalf";
 export declare const TOPIC_CHAT = "lk.chat";
+export declare const ATTRIBUTE_AGENT_STATE = "lk.agent.state";
+export declare const ATTRIBUTE_AGENT_NAME = "lk.agent.name";
+export declare const TOPIC_CLIENT_EVENTS = "lk.agent.events";
+export declare const RPC_GET_SESSION_STATE = "lk.agent.get_session_state";
+export declare const RPC_GET_CHAT_HISTORY = "lk.agent.get_chat_history";
+export declare const RPC_GET_AGENT_INFO = "lk.agent.get_agent_info";
+export declare const RPC_SEND_MESSAGE = "lk.agent.send_message";
+export declare const TOPIC_AGENT_REQUEST = "lk.agent.request";
+export declare const TOPIC_AGENT_RESPONSE = "lk.agent.response";
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,gCAAgC,4BAA4B,CAAC;AAC1E,eAAO,MAAM,6BAA6B,2BAA2B,CAAC;AACtE,eAAO,MAAM,mBAAmB,qBAAqB,CAAC;AACtD,eAAO,MAAM,kCAAkC,kBAAkB,CAAC;AAClE,eAAO,MAAM,2BAA2B,yBAAyB,CAAC;AAClE,eAAO,MAAM,UAAU,YAAY,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,gCAAgC,4BAA4B,CAAC;AAC1E,eAAO,MAAM,6BAA6B,2BAA2B,CAAC;AACtE,eAAO,MAAM,mBAAmB,qBAAqB,CAAC;AACtD,eAAO,MAAM,kCAAkC,kBAAkB,CAAC;AAClE,eAAO,MAAM,2BAA2B,yBAAyB,CAAC;AAClE,eAAO,MAAM,UAAU,YAAY,CAAC;AAEpC,eAAO,MAAM,qBAAqB,mBAAmB,CAAC;AACtD,eAAO,MAAM,oBAAoB,kBAAkB,CAAC;AAIpD,eAAO,MAAM,mBAAmB,oBAAoB,CAAC;AACrD,eAAO,MAAM,qBAAqB,+BAA+B,CAAC;AAClE,eAAO,MAAM,oBAAoB,8BAA8B,CAAC;AAChE,eAAO,MAAM,kBAAkB,4BAA4B,CAAC;AAC5D,eAAO,MAAM,gBAAgB,0BAA0B,CAAC;AACxD,eAAO,MAAM,mBAAmB,qBAAqB,CAAC;AACtD,eAAO,MAAM,oBAAoB,sBAAsB,CAAC"}