@mastra/livekit 0.0.0 → 0.2.0-alpha.0

package/dist/chunk-2E3MTAOA.js

@@ -0,0 +1,133 @@
+import { ReadableStream } from 'stream/web';
+
+// src/constants.ts
+var DEFAULT_LIVEKIT_AGENT_NAME = "mastra-voice";
+
+// src/metadata.ts
+function parseSessionMetadata(raw) {
+  if (!raw) return {};
+  try {
+    const parsed = JSON.parse(raw);
+    if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+      return parsed;
+    }
+  } catch {
+  }
+  return {};
+}
+function serializeSessionMetadata(metadata) {
+  return JSON.stringify(metadata);
+}
+function unwrapStepText(output) {
+  if (typeof output === "string") return output;
+  if (output && typeof output === "object" && output.type === "text-delta") {
+    const text = output.payload?.text;
+    return typeof text === "string" ? text : void 0;
+  }
+  return void 0;
+}
+function unwrapStepToolCall(output) {
+  if (!output || typeof output !== "object" || output.type !== "tool-call") return void 0;
+  const payload = output.payload;
+  if (payload && typeof payload.toolCallId === "string" && typeof payload.toolName === "string") {
+    return { toolCallId: payload.toolCallId, toolName: payload.toolName, args: payload.args };
+  }
+  return void 0;
+}
+function pipeAgentReplyToWriter(agentStream, writer) {
+  let text = "";
+  const forwarded = new ReadableStream({
+    start: async (controller) => {
+      for await (const chunk of agentStream.fullStream) {
+        const type = chunk?.type;
+        if (type === "text-delta") {
+          const delta = chunk.payload?.text;
+          if (typeof delta === "string" && delta) {
+            text += delta;
+            controller.enqueue(chunk);
+          }
+        } else if (type === "tool-call") {
+          controller.enqueue(chunk);
+        }
+      }
+      controller.close();
+    }
+  });
+  return forwarded.pipeTo(writer).then(() => text);
+}
+function createWorkflowReplyGenerator(options) {
+  const { workflow, workflowInput, replyStep, resultText, toolFeedback, onTurnComplete } = options;
+  return async (ctx) => {
+    const inputData = await workflowInput(ctx);
+    const run = await workflow.createRun();
+    const streamArgs = {
+      inputData
+    };
+    if (ctx.tracingContext) streamArgs.tracingContext = ctx.tracingContext;
+    if (ctx.requestContext) streamArgs.requestContext = ctx.requestContext;
+    const output = run.stream(streamArgs);
+    let cancelled = false;
+    let replyText = "";
+    const toolCalls = [];
+    const emitTurnComplete = (interrupted) => {
+      if (!onTurnComplete) return;
+      const completeCtx = { ...ctx, result: { text: replyText, toolCalls, interrupted } };
+      Promise.resolve().then(() => onTurnComplete(completeCtx)).catch((error) => {
+        console.warn("@mastra/livekit: onTurnComplete hook threw", error);
+      });
+    };
+    return new ReadableStream({
+      start: async (controller) => {
+        let streamedAny = false;
+        try {
+          for await (const chunk of output.fullStream) {
+            if (cancelled) break;
+            if (chunk.type !== "workflow-step-output") continue;
+            const payload = chunk.payload;
+            if (replyStep && payload.stepName !== replyStep) continue;
+            const text = unwrapStepText(payload.output);
+            if (text) {
+              streamedAny = true;
+              replyText += text;
+              controller.enqueue(text);
+              continue;
+            }
+            const toolCall = unwrapStepToolCall(payload.output);
+            if (toolCall) {
+              toolCalls.push(toolCall);
+              if (toolFeedback) {
+                const filler = toolFeedback(toolCall);
+                if (filler) controller.enqueue(filler.endsWith(" ") ? filler : `${filler} `);
+              }
+            }
+          }
+          if (!cancelled && !streamedAny && resultText) {
+            const finalText = resultText(await output.result);
+            if (finalText) {
+              replyText += finalText;
+              controller.enqueue(finalText);
+            }
+          }
+          if (!cancelled) controller.close();
+          emitTurnComplete(cancelled);
+        } catch (error) {
+          if (cancelled) {
+            emitTurnComplete(true);
+            return;
+          }
+          controller.error(error);
+        }
+      },
+      cancel: () => {
+        cancelled = true;
+        void Promise.resolve(run.cancel()).catch((error) => {
+          console.warn("@mastra/livekit: failed to cancel the workflow run on barge-in", error);
+        });
+      }
+    });
+  };
+}
+
+export { DEFAULT_LIVEKIT_AGENT_NAME, createWorkflowReplyGenerator, parseSessionMetadata, pipeAgentReplyToWriter, serializeSessionMetadata };
+//# sourceMappingURL=chunk-2E3MTAOA.js.map
+//# sourceMappingURL=chunk-2E3MTAOA.js.map

package/dist/chunk-2E3MTAOA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/constants.ts","../src/metadata.ts","../src/workflow-generator.ts"],"names":[],"mappings":"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","file":"chunk-2E3MTAOA.js","sourcesContent":["/** Default LiveKit agent name used for explicit dispatch when none is configured. */\nexport const DEFAULT_LIVEKIT_AGENT_NAME = 'mastra-voice';\n","/**\n * Session metadata passed from the Mastra server to the LiveKit agent worker through\n * LiveKit's job dispatch metadata (a plain string, so this is JSON-serialized).\n */\nexport interface LiveKitSessionMetadata {\n  /** Mastra agent to run, by registered key or agent id. */\n  agentId?: string;\n  /** Memory thread id. Defaults to the LiveKit room name when omitted. */\n  threadId?: string;\n  /** Memory resource id (typically the end user id). */\n  resourceId?: string;\n  /** Plain-object entries restored into a RequestContext for agent execution. */\n  requestContext?: Record<string, unknown>;\n}\n\nexport function parseSessionMetadata(raw: string | undefined | null): LiveKitSessionMetadata {\n  if (!raw) return {};\n  try {\n    const parsed = JSON.parse(raw);\n    if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {\n      return parsed as LiveKitSessionMetadata;\n    }\n  } catch {\n    // Dispatch metadata is user-controlled and may not be JSON; treat as absent.\n  }\n  return {};\n}\n\nexport function serializeSessionMetadata(metadata: LiveKitSessionMetadata): string {\n  return JSON.stringify(metadata);\n}\n","import { ReadableStream } from 'node:stream/web';\nimport type { WritableStream } from 'node:stream/web';\nimport type { TracingContext } from '@mastra/core/observability';\nimport type { RequestContext } from '@mastra/core/request-context';\nimport type { Workflow } from '@mastra/core/workflows';\nimport type {\n  VoiceReplyGenerator,\n  VoiceToolCall,\n  VoiceTurnCompleteContext,\n  VoiceTurnCompleteHook,\n  VoiceTurnContext,\n} from './bridge';\n\nexport interface WorkflowReplyGeneratorOptions {\n  /** The Mastra workflow that generates each turn's reply. Runs once per turn (no suspend/resume). */\n  workflow: Workflow;\n  /**\n   * Maps a turn into the workflow's `inputData`. Required — input schemas are caller-defined.\n   * A common shape passes the full transcript so the workflow is stateless between turns, e.g.\n   * `ctx => ({ history: chatContextToMessages(ctx.chatCtx) })`.\n   */\n  workflowInput: (ctx: VoiceTurnContext) => unknown | Promise<unknown>;\n  /**\n   * Only stream text from this step (by id). Defaults to every step that writes text to its\n   * `writer`. Set when multiple steps write and only one produces the spoken reply.\n   */\n  replyStep?: string;\n  /**\n   * Fallback when the workflow streams no text via `writer`: derive the spoken reply from the\n   * final run result. Without this, a non-streaming workflow stays silent. Streaming via the\n   * step `writer` is preferred — it gives the caller low time-to-first-token.\n   */\n  resultText?: (result: unknown) => string | undefined | void;\n  /**\n   * Speak a short phrase while a tool call runs. Fires only for tool calls the reply step surfaces\n   * to its `writer` — use {@link pipeAgentReplyToWriter} (or pipe the agent's `fullStream`) so\n   * `tool-call` chunks reach the stream. See {@link MastraVoiceAgentOptions.toolFeedback}.\n   */\n  toolFeedback?: (toolCall: VoiceToolCall) => string | undefined | void;\n  /**\n   * Fired off the audio path after the reply streams, fire-and-forget. Carries the produced reply\n   * text and any tool calls the workflow surfaced. See {@link MastraVoiceAgentOptions.onTurnComplete}.\n   */\n  onTurnComplete?: VoiceTurnCompleteHook;\n}\n\n/**\n * Unwraps the text carried by a `workflow-step-output` chunk's `payload.output`. A step that\n * pipes `agent.stream().textStream` into its `writer` produces raw strings; a step built from an\n * agent (`createStep(agent)`) produces full `text-delta` chunks. Returns the text for both, or\n * `undefined` for any other shape.\n */\nexport function unwrapStepText(output: unknown): string | undefined {\n  if (typeof output === 'string') return output;\n  if (output && typeof output === 'object' && (output as { type?: unknown }).type === 'text-delta') {\n    const text = (output as { payload?: { text?: unknown } }).payload?.text;\n    return typeof text === 'string' ? text : undefined;\n  }\n  return undefined;\n}\n\n/**\n * Unwraps a tool call carried by a `workflow-step-output` chunk's `payload.output`. A step that\n * pipes the agent's `fullStream` (rather than just `textStream`) into its `writer` surfaces\n * `tool-call` chunks; this returns the {@link VoiceToolCall} for those, or `undefined` otherwise.\n */\nexport function unwrapStepToolCall(output: unknown): VoiceToolCall | undefined {\n  if (!output || typeof output !== 'object' || (output as { type?: unknown }).type !== 'tool-call') return undefined;\n  const payload = (output as { payload?: { toolCallId?: unknown; toolName?: unknown; args?: unknown } }).payload;\n  if (payload && typeof payload.toolCallId === 'string' && typeof payload.toolName === 'string') {\n    return { toolCallId: payload.toolCallId, toolName: payload.toolName, args: payload.args };\n  }\n  return undefined;\n}\n\n/** The minimal shape of a Mastra agent stream consumed by {@link pipeAgentReplyToWriter}. */\nexport interface AgentReplyStreamLike {\n  fullStream: AsyncIterable<unknown>;\n}\n\n/**\n * Streams a Mastra agent's reply into a workflow step's `writer` for the LiveKit workflow\n * entrypoint — the recommended way to drive a turn's reply from a step.\n *\n * It forwards the agent's text deltas (so text-to-speech starts before the full reply is ready)\n * AND its `tool-call` chunks (so {@link WorkflowReplyGeneratorOptions.toolFeedback} fires and\n * {@link WorkflowReplyGeneratorOptions.onTurnComplete}'s `result.toolCalls` is populated). This is\n * the difference from piping only `agent.stream().textStream`, which silently drops tool calls.\n * Other chunk types (reasoning, tool results, lifecycle) are not forwarded, keeping the spoken\n * stream clean. Returns the accumulated reply text for the step to return.\n *\n * Pass the step's `abortSignal` to `agent.stream(...)` so barge-in stops generation promptly.\n *\n * ```ts\n * const generateResponse = createStep({\n *   // ...\n *   execute: async ({ inputData, mastra, writer, abortSignal }) => {\n *     const stream = await mastra.getAgent('callCenter').stream(inputData.turn, { abortSignal });\n *     const reply = await pipeAgentReplyToWriter(stream, writer);\n *     return { reply };\n *   },\n * });\n * ```\n */\nexport function pipeAgentReplyToWriter(\n  agentStream: AgentReplyStreamLike,\n  writer: WritableStream<unknown>,\n): Promise<string> {\n  let text = '';\n  // Re-emit only the chunks the voice path cares about, then pipe through the step writer — which\n  // reuses pipeTo's proven backpressure + close handling rather than driving the writer by hand.\n  const forwarded = new ReadableStream<unknown>({\n    start: async controller => {\n      for await (const chunk of agentStream.fullStream) {\n        const type = (chunk as { type?: unknown })?.type;\n        if (type === 'text-delta') {\n          const delta = (chunk as { payload?: { text?: unknown } }).payload?.text;\n          if (typeof delta === 'string' && delta) {\n            text += delta;\n            controller.enqueue(chunk);\n          }\n        } else if (type === 'tool-call') {\n          controller.enqueue(chunk);\n        }\n      }\n      controller.close();\n    },\n  });\n  return forwarded.pipeTo(writer).then(() => text);\n}\n\n/**\n * A {@link VoiceReplyGenerator} backed by a Mastra workflow. Per turn it starts a fresh run to\n * completion (LiveKit owns the turn boundary, so there is no suspend/resume and no conversation\n * state carried between turns) and streams the text its steps write to their `writer`.\n *\n * A workflow's own stream emits structured step events, not token deltas — text only surfaces\n * when a step pipes it into the injected `writer`, arriving as `workflow-step-output` chunks. The\n * simplest correct reply step calls {@link pipeAgentReplyToWriter}, which forwards both text and\n * tool calls (and passes the step's `abortSignal` through `agent.stream` so barge-in stops\n * generation promptly). Piping only `agent.stream(...).textStream.pipeTo(writer)` works for text\n * but silently drops tool calls, so {@link WorkflowReplyGeneratorOptions.toolFeedback} and\n * {@link WorkflowReplyGeneratorOptions.onTurnComplete}'s `result.toolCalls` stay empty.\n */\nexport function createWorkflowReplyGenerator(options: WorkflowReplyGeneratorOptions): VoiceReplyGenerator {\n  const { workflow, workflowInput, replyStep, resultText, toolFeedback, onTurnComplete } = options;\n  return async ctx => {\n    const inputData = await workflowInput(ctx);\n    const run = await workflow.createRun();\n\n    const streamArgs: { inputData: unknown; tracingContext?: TracingContext; requestContext?: RequestContext } = {\n      inputData,\n    };\n    if (ctx.tracingContext) streamArgs.tracingContext = ctx.tracingContext;\n    // Forward the per-session request context so workflow steps see it, mirroring the agent path.\n    if (ctx.requestContext) streamArgs.requestContext = ctx.requestContext;\n    const output = run.stream(streamArgs);\n\n    let cancelled = false;\n    // Accumulated as the turn streams so the post-turn hook can see what was actually produced.\n    let replyText = '';\n    const toolCalls: VoiceToolCall[] = [];\n\n    // Fire-and-forget after the reply has streamed: off the audio path and not awaited, so it\n    // never delays the next turn. Errors are logged, not thrown. Mirrors createAgentReplyGenerator.\n    const emitTurnComplete = (interrupted: boolean) => {\n      if (!onTurnComplete) return;\n      const completeCtx: VoiceTurnCompleteContext = { ...ctx, result: { text: replyText, toolCalls, interrupted } };\n      Promise.resolve()\n        .then(() => onTurnComplete(completeCtx))\n        .catch(error => {\n          console.warn('@mastra/livekit: onTurnComplete hook threw', error);\n        });\n    };\n\n    return new ReadableStream<string>({\n      start: async controller => {\n        let streamedAny = false;\n        try {\n          for await (const chunk of output.fullStream) {\n            if (cancelled) break;\n            if (chunk.type !== 'workflow-step-output') continue;\n            const payload = chunk.payload as { output?: unknown; stepName?: unknown };\n            if (replyStep && payload.stepName !== replyStep) continue;\n            const text = unwrapStepText(payload.output);\n            if (text) {\n              streamedAny = true;\n              replyText += text;\n              controller.enqueue(text);\n              continue;\n            }\n            // A tool call only surfaces when the step pipes the agent's fullStream; when it does,\n            // mirror the agent path — record it and speak any toolFeedback filler.\n            const toolCall = unwrapStepToolCall(payload.output);\n            if (toolCall) {\n              toolCalls.push(toolCall);\n              if (toolFeedback) {\n                const filler = toolFeedback(toolCall);\n                if (filler) controller.enqueue(filler.endsWith(' ') ? filler : `${filler} `);\n              }\n            }\n          }\n          if (!cancelled && !streamedAny && resultText) {\n            const finalText = resultText(await output.result);\n            if (finalText) {\n              replyText += finalText;\n              controller.enqueue(finalText);\n            }\n          }\n          if (!cancelled) controller.close();\n          // Success, or a clean barge-in break out of the loop: the turn is done either way.\n          emitTurnComplete(cancelled);\n        } catch (error) {\n          // Barge-in cancels the run; that's not a failure — the turn still completed\n          // (interrupted), so the hook still fires for memory reconciliation.\n          if (cancelled) {\n            emitTurnComplete(true);\n            return;\n          }\n          controller.error(error);\n        }\n      },\n      cancel: () => {\n        cancelled = true;\n        // Barge-in fires this synchronously; swallow any rejection from the run cancellation so a\n        // failed cancel can't surface as an unhandled promise rejection.\n        void Promise.resolve(run.cancel()).catch(error => {\n          console.warn('@mastra/livekit: failed to cancel the workflow run on barge-in', error);\n        });\n      },\n    });\n  };\n}\n"]}

package/dist/chunk-MWTEZOBS.cjs

@@ -0,0 +1,139 @@
+'use strict';
+
+var web = require('stream/web');
+
+// src/constants.ts
+var DEFAULT_LIVEKIT_AGENT_NAME = "mastra-voice";
+
+// src/metadata.ts
+function parseSessionMetadata(raw) {
+  if (!raw) return {};
+  try {
+    const parsed = JSON.parse(raw);
+    if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+      return parsed;
+    }
+  } catch {
+  }
+  return {};
+}
+function serializeSessionMetadata(metadata) {
+  return JSON.stringify(metadata);
+}
+function unwrapStepText(output) {
+  if (typeof output === "string") return output;
+  if (output && typeof output === "object" && output.type === "text-delta") {
+    const text = output.payload?.text;
+    return typeof text === "string" ? text : void 0;
+  }
+  return void 0;
+}
+function unwrapStepToolCall(output) {
+  if (!output || typeof output !== "object" || output.type !== "tool-call") return void 0;
+  const payload = output.payload;
+  if (payload && typeof payload.toolCallId === "string" && typeof payload.toolName === "string") {
+    return { toolCallId: payload.toolCallId, toolName: payload.toolName, args: payload.args };
+  }
+  return void 0;
+}
+function pipeAgentReplyToWriter(agentStream, writer) {
+  let text = "";
+  const forwarded = new web.ReadableStream({
+    start: async (controller) => {
+      for await (const chunk of agentStream.fullStream) {
+        const type = chunk?.type;
+        if (type === "text-delta") {
+          const delta = chunk.payload?.text;
+          if (typeof delta === "string" && delta) {
+            text += delta;
+            controller.enqueue(chunk);
+          }
+        } else if (type === "tool-call") {
+          controller.enqueue(chunk);
+        }
+      }
+      controller.close();
+    }
+  });
+  return forwarded.pipeTo(writer).then(() => text);
+}
+function createWorkflowReplyGenerator(options) {
+  const { workflow, workflowInput, replyStep, resultText, toolFeedback, onTurnComplete } = options;
+  return async (ctx) => {
+    const inputData = await workflowInput(ctx);
+    const run = await workflow.createRun();
+    const streamArgs = {
+      inputData
+    };
+    if (ctx.tracingContext) streamArgs.tracingContext = ctx.tracingContext;
+    if (ctx.requestContext) streamArgs.requestContext = ctx.requestContext;
+    const output = run.stream(streamArgs);
+    let cancelled = false;
+    let replyText = "";
+    const toolCalls = [];
+    const emitTurnComplete = (interrupted) => {
+      if (!onTurnComplete) return;
+      const completeCtx = { ...ctx, result: { text: replyText, toolCalls, interrupted } };
+      Promise.resolve().then(() => onTurnComplete(completeCtx)).catch((error) => {
+        console.warn("@mastra/livekit: onTurnComplete hook threw", error);
+      });
+    };
+    return new web.ReadableStream({
+      start: async (controller) => {
+        let streamedAny = false;
+        try {
+          for await (const chunk of output.fullStream) {
+            if (cancelled) break;
+            if (chunk.type !== "workflow-step-output") continue;
+            const payload = chunk.payload;
+            if (replyStep && payload.stepName !== replyStep) continue;
+            const text = unwrapStepText(payload.output);
+            if (text) {
+              streamedAny = true;
+              replyText += text;
+              controller.enqueue(text);
+              continue;
+            }
+            const toolCall = unwrapStepToolCall(payload.output);
+            if (toolCall) {
+              toolCalls.push(toolCall);
+              if (toolFeedback) {
+                const filler = toolFeedback(toolCall);
+                if (filler) controller.enqueue(filler.endsWith(" ") ? filler : `${filler} `);
+              }
+            }
+          }
+          if (!cancelled && !streamedAny && resultText) {
+            const finalText = resultText(await output.result);
+            if (finalText) {
+              replyText += finalText;
+              controller.enqueue(finalText);
+            }
+          }
+          if (!cancelled) controller.close();
+          emitTurnComplete(cancelled);
+        } catch (error) {
+          if (cancelled) {
+            emitTurnComplete(true);
+            return;
+          }
+          controller.error(error);
+        }
+      },
+      cancel: () => {
+        cancelled = true;
+        void Promise.resolve(run.cancel()).catch((error) => {
+          console.warn("@mastra/livekit: failed to cancel the workflow run on barge-in", error);
+        });
+      }
+    });
+  };
+}
+
+exports.DEFAULT_LIVEKIT_AGENT_NAME = DEFAULT_LIVEKIT_AGENT_NAME;
+exports.createWorkflowReplyGenerator = createWorkflowReplyGenerator;
+exports.parseSessionMetadata = parseSessionMetadata;
+exports.pipeAgentReplyToWriter = pipeAgentReplyToWriter;
+exports.serializeSessionMetadata = serializeSessionMetadata;
+//# sourceMappingURL=chunk-MWTEZOBS.cjs.map
+//# sourceMappingURL=chunk-MWTEZOBS.cjs.map

package/dist/chunk-MWTEZOBS.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/constants.ts","../src/metadata.ts","../src/workflow-generator.ts"],"names":["ReadableStream"],"mappings":"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","file":"chunk-MWTEZOBS.cjs","sourcesContent":["/** Default LiveKit agent name used for explicit dispatch when none is configured. */\nexport const DEFAULT_LIVEKIT_AGENT_NAME = 'mastra-voice';\n","/**\n * Session metadata passed from the Mastra server to the LiveKit agent worker through\n * LiveKit's job dispatch metadata (a plain string, so this is JSON-serialized).\n */\nexport interface LiveKitSessionMetadata {\n  /** Mastra agent to run, by registered key or agent id. */\n  agentId?: string;\n  /** Memory thread id. Defaults to the LiveKit room name when omitted. */\n  threadId?: string;\n  /** Memory resource id (typically the end user id). */\n  resourceId?: string;\n  /** Plain-object entries restored into a RequestContext for agent execution. */\n  requestContext?: Record<string, unknown>;\n}\n\nexport function parseSessionMetadata(raw: string | undefined | null): LiveKitSessionMetadata {\n  if (!raw) return {};\n  try {\n    const parsed = JSON.parse(raw);\n    if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {\n      return parsed as LiveKitSessionMetadata;\n    }\n  } catch {\n    // Dispatch metadata is user-controlled and may not be JSON; treat as absent.\n  }\n  return {};\n}\n\nexport function serializeSessionMetadata(metadata: LiveKitSessionMetadata): string {\n  return JSON.stringify(metadata);\n}\n","import { ReadableStream } from 'node:stream/web';\nimport type { WritableStream } from 'node:stream/web';\nimport type { TracingContext } from '@mastra/core/observability';\nimport type { RequestContext } from '@mastra/core/request-context';\nimport type { Workflow } from '@mastra/core/workflows';\nimport type {\n  VoiceReplyGenerator,\n  VoiceToolCall,\n  VoiceTurnCompleteContext,\n  VoiceTurnCompleteHook,\n  VoiceTurnContext,\n} from './bridge';\n\nexport interface WorkflowReplyGeneratorOptions {\n  /** The Mastra workflow that generates each turn's reply. Runs once per turn (no suspend/resume). */\n  workflow: Workflow;\n  /**\n   * Maps a turn into the workflow's `inputData`. Required — input schemas are caller-defined.\n   * A common shape passes the full transcript so the workflow is stateless between turns, e.g.\n   * `ctx => ({ history: chatContextToMessages(ctx.chatCtx) })`.\n   */\n  workflowInput: (ctx: VoiceTurnContext) => unknown | Promise<unknown>;\n  /**\n   * Only stream text from this step (by id). Defaults to every step that writes text to its\n   * `writer`. Set when multiple steps write and only one produces the spoken reply.\n   */\n  replyStep?: string;\n  /**\n   * Fallback when the workflow streams no text via `writer`: derive the spoken reply from the\n   * final run result. Without this, a non-streaming workflow stays silent. Streaming via the\n   * step `writer` is preferred — it gives the caller low time-to-first-token.\n   */\n  resultText?: (result: unknown) => string | undefined | void;\n  /**\n   * Speak a short phrase while a tool call runs. Fires only for tool calls the reply step surfaces\n   * to its `writer` — use {@link pipeAgentReplyToWriter} (or pipe the agent's `fullStream`) so\n   * `tool-call` chunks reach the stream. See {@link MastraVoiceAgentOptions.toolFeedback}.\n   */\n  toolFeedback?: (toolCall: VoiceToolCall) => string | undefined | void;\n  /**\n   * Fired off the audio path after the reply streams, fire-and-forget. Carries the produced reply\n   * text and any tool calls the workflow surfaced. See {@link MastraVoiceAgentOptions.onTurnComplete}.\n   */\n  onTurnComplete?: VoiceTurnCompleteHook;\n}\n\n/**\n * Unwraps the text carried by a `workflow-step-output` chunk's `payload.output`. A step that\n * pipes `agent.stream().textStream` into its `writer` produces raw strings; a step built from an\n * agent (`createStep(agent)`) produces full `text-delta` chunks. Returns the text for both, or\n * `undefined` for any other shape.\n */\nexport function unwrapStepText(output: unknown): string | undefined {\n  if (typeof output === 'string') return output;\n  if (output && typeof output === 'object' && (output as { type?: unknown }).type === 'text-delta') {\n    const text = (output as { payload?: { text?: unknown } }).payload?.text;\n    return typeof text === 'string' ? text : undefined;\n  }\n  return undefined;\n}\n\n/**\n * Unwraps a tool call carried by a `workflow-step-output` chunk's `payload.output`. A step that\n * pipes the agent's `fullStream` (rather than just `textStream`) into its `writer` surfaces\n * `tool-call` chunks; this returns the {@link VoiceToolCall} for those, or `undefined` otherwise.\n */\nexport function unwrapStepToolCall(output: unknown): VoiceToolCall | undefined {\n  if (!output || typeof output !== 'object' || (output as { type?: unknown }).type !== 'tool-call') return undefined;\n  const payload = (output as { payload?: { toolCallId?: unknown; toolName?: unknown; args?: unknown } }).payload;\n  if (payload && typeof payload.toolCallId === 'string' && typeof payload.toolName === 'string') {\n    return { toolCallId: payload.toolCallId, toolName: payload.toolName, args: payload.args };\n  }\n  return undefined;\n}\n\n/** The minimal shape of a Mastra agent stream consumed by {@link pipeAgentReplyToWriter}. */\nexport interface AgentReplyStreamLike {\n  fullStream: AsyncIterable<unknown>;\n}\n\n/**\n * Streams a Mastra agent's reply into a workflow step's `writer` for the LiveKit workflow\n * entrypoint — the recommended way to drive a turn's reply from a step.\n *\n * It forwards the agent's text deltas (so text-to-speech starts before the full reply is ready)\n * AND its `tool-call` chunks (so {@link WorkflowReplyGeneratorOptions.toolFeedback} fires and\n * {@link WorkflowReplyGeneratorOptions.onTurnComplete}'s `result.toolCalls` is populated). This is\n * the difference from piping only `agent.stream().textStream`, which silently drops tool calls.\n * Other chunk types (reasoning, tool results, lifecycle) are not forwarded, keeping the spoken\n * stream clean. Returns the accumulated reply text for the step to return.\n *\n * Pass the step's `abortSignal` to `agent.stream(...)` so barge-in stops generation promptly.\n *\n * ```ts\n * const generateResponse = createStep({\n *   // ...\n *   execute: async ({ inputData, mastra, writer, abortSignal }) => {\n *     const stream = await mastra.getAgent('callCenter').stream(inputData.turn, { abortSignal });\n *     const reply = await pipeAgentReplyToWriter(stream, writer);\n *     return { reply };\n *   },\n * });\n * ```\n */\nexport function pipeAgentReplyToWriter(\n  agentStream: AgentReplyStreamLike,\n  writer: WritableStream<unknown>,\n): Promise<string> {\n  let text = '';\n  // Re-emit only the chunks the voice path cares about, then pipe through the step writer — which\n  // reuses pipeTo's proven backpressure + close handling rather than driving the writer by hand.\n  const forwarded = new ReadableStream<unknown>({\n    start: async controller => {\n      for await (const chunk of agentStream.fullStream) {\n        const type = (chunk as { type?: unknown })?.type;\n        if (type === 'text-delta') {\n          const delta = (chunk as { payload?: { text?: unknown } }).payload?.text;\n          if (typeof delta === 'string' && delta) {\n            text += delta;\n            controller.enqueue(chunk);\n          }\n        } else if (type === 'tool-call') {\n          controller.enqueue(chunk);\n        }\n      }\n      controller.close();\n    },\n  });\n  return forwarded.pipeTo(writer).then(() => text);\n}\n\n/**\n * A {@link VoiceReplyGenerator} backed by a Mastra workflow. Per turn it starts a fresh run to\n * completion (LiveKit owns the turn boundary, so there is no suspend/resume and no conversation\n * state carried between turns) and streams the text its steps write to their `writer`.\n *\n * A workflow's own stream emits structured step events, not token deltas — text only surfaces\n * when a step pipes it into the injected `writer`, arriving as `workflow-step-output` chunks. The\n * simplest correct reply step calls {@link pipeAgentReplyToWriter}, which forwards both text and\n * tool calls (and passes the step's `abortSignal` through `agent.stream` so barge-in stops\n * generation promptly). Piping only `agent.stream(...).textStream.pipeTo(writer)` works for text\n * but silently drops tool calls, so {@link WorkflowReplyGeneratorOptions.toolFeedback} and\n * {@link WorkflowReplyGeneratorOptions.onTurnComplete}'s `result.toolCalls` stay empty.\n */\nexport function createWorkflowReplyGenerator(options: WorkflowReplyGeneratorOptions): VoiceReplyGenerator {\n  const { workflow, workflowInput, replyStep, resultText, toolFeedback, onTurnComplete } = options;\n  return async ctx => {\n    const inputData = await workflowInput(ctx);\n    const run = await workflow.createRun();\n\n    const streamArgs: { inputData: unknown; tracingContext?: TracingContext; requestContext?: RequestContext } = {\n      inputData,\n    };\n    if (ctx.tracingContext) streamArgs.tracingContext = ctx.tracingContext;\n    // Forward the per-session request context so workflow steps see it, mirroring the agent path.\n    if (ctx.requestContext) streamArgs.requestContext = ctx.requestContext;\n    const output = run.stream(streamArgs);\n\n    let cancelled = false;\n    // Accumulated as the turn streams so the post-turn hook can see what was actually produced.\n    let replyText = '';\n    const toolCalls: VoiceToolCall[] = [];\n\n    // Fire-and-forget after the reply has streamed: off the audio path and not awaited, so it\n    // never delays the next turn. Errors are logged, not thrown. Mirrors createAgentReplyGenerator.\n    const emitTurnComplete = (interrupted: boolean) => {\n      if (!onTurnComplete) return;\n      const completeCtx: VoiceTurnCompleteContext = { ...ctx, result: { text: replyText, toolCalls, interrupted } };\n      Promise.resolve()\n        .then(() => onTurnComplete(completeCtx))\n        .catch(error => {\n          console.warn('@mastra/livekit: onTurnComplete hook threw', error);\n        });\n    };\n\n    return new ReadableStream<string>({\n      start: async controller => {\n        let streamedAny = false;\n        try {\n          for await (const chunk of output.fullStream) {\n            if (cancelled) break;\n            if (chunk.type !== 'workflow-step-output') continue;\n            const payload = chunk.payload as { output?: unknown; stepName?: unknown };\n            if (replyStep && payload.stepName !== replyStep) continue;\n            const text = unwrapStepText(payload.output);\n            if (text) {\n              streamedAny = true;\n              replyText += text;\n              controller.enqueue(text);\n              continue;\n            }\n            // A tool call only surfaces when the step pipes the agent's fullStream; when it does,\n            // mirror the agent path — record it and speak any toolFeedback filler.\n            const toolCall = unwrapStepToolCall(payload.output);\n            if (toolCall) {\n              toolCalls.push(toolCall);\n              if (toolFeedback) {\n                const filler = toolFeedback(toolCall);\n                if (filler) controller.enqueue(filler.endsWith(' ') ? filler : `${filler} `);\n              }\n            }\n          }\n          if (!cancelled && !streamedAny && resultText) {\n            const finalText = resultText(await output.result);\n            if (finalText) {\n              replyText += finalText;\n              controller.enqueue(finalText);\n            }\n          }\n          if (!cancelled) controller.close();\n          // Success, or a clean barge-in break out of the loop: the turn is done either way.\n          emitTurnComplete(cancelled);\n        } catch (error) {\n          // Barge-in cancels the run; that's not a failure — the turn still completed\n          // (interrupted), so the hook still fires for memory reconciliation.\n          if (cancelled) {\n            emitTurnComplete(true);\n            return;\n          }\n          controller.error(error);\n        }\n      },\n      cancel: () => {\n        cancelled = true;\n        // Barge-in fires this synchronously; swallow any rejection from the run cancellation so a\n        // failed cancel can't surface as an unhandled promise rejection.\n        void Promise.resolve(run.cancel()).catch(error => {\n          console.warn('@mastra/livekit: failed to cancel the workflow run on barge-in', error);\n        });\n      },\n    });\n  };\n}\n"]}

package/dist/constants.d.ts

@@ -0,0 +1,3 @@
+/** Default LiveKit agent name used for explicit dispatch when none is configured. */
+export declare const DEFAULT_LIVEKIT_AGENT_NAME = "mastra-voice";
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,eAAO,MAAM,0BAA0B,iBAAiB,CAAC"}

package/dist/dispatch.d.ts

@@ -0,0 +1,20 @@
+import type { LiveKitSessionMetadata } from './metadata.js';
+export interface DispatchVoiceSessionOptions {
+    /** Room to dispatch the agent into (created on demand). */
+    roomName: string;
+    /** Must match the worker's `agentName`. Defaults to `'mastra-voice'`. */
+    agentName?: string;
+    metadata?: LiveKitSessionMetadata;
+    /** Defaults to `LIVEKIT_URL`. */
+    serverUrl?: string;
+    /** Defaults to `LIVEKIT_API_KEY`. */
+    apiKey?: string;
+    /** Defaults to `LIVEKIT_API_SECRET`. */
+    apiSecret?: string;
+}
+/**
+ * Programmatically dispatches a Mastra voice agent into a LiveKit room — for
+ * server-initiated sessions such as outbound calls or joining an existing room.
+ */
+export declare function dispatchVoiceSession(options: DispatchVoiceSessionOptions): Promise<import("livekit-server-sdk").AgentDispatch>;
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD,MAAM,WAAW,2BAA2B;IAC1C,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAClC,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,2BAA2B,uDAgB9E"}

package/dist/index.cjs

@@ -0,0 +1,105 @@
+'use strict';
+
+var chunkMWTEZOBS_cjs = require('./chunk-MWTEZOBS.cjs');
+var crypto = require('crypto');
+var protocol = require('@livekit/protocol');
+var livekitServerSdk = require('livekit-server-sdk');
+
+function stringField(body, key) {
+  const value = body[key];
+  return typeof value === "string" && value.length > 0 ? value : void 0;
+}
+function liveKitConnectionRoute(options = {}) {
+  const handler = async (c) => {
+    const serverUrl = options.serverUrl ?? process.env.LIVEKIT_URL;
+    const apiKey = options.apiKey ?? process.env.LIVEKIT_API_KEY;
+    const apiSecret = options.apiSecret ?? process.env.LIVEKIT_API_SECRET;
+    if (!serverUrl || !apiKey || !apiSecret) {
+      return c.json(
+        {
+          error: "LiveKit is not configured. Set LIVEKIT_URL, LIVEKIT_API_KEY, and LIVEKIT_API_SECRET (or pass serverUrl/apiKey/apiSecret to liveKitConnectionRoute)."
+        },
+        500
+      );
+    }
+    const body = await c.req.json().then(
+      (parsed) => parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {}
+    ).catch(() => ({}));
+    const args = { body, context: c };
+    const metadata = options.metadata ? await options.metadata(args) : {
+      agentId: stringField(body, "agentId"),
+      threadId: stringField(body, "threadId"),
+      resourceId: stringField(body, "resourceId")
+    };
+    const roomName = typeof options.roomName === "function" ? options.roomName(args) : options.roomName ?? `mastra-voice-${crypto.randomUUID().slice(0, 8)}`;
+    const identity = typeof options.participantIdentity === "function" ? options.participantIdentity(args) : options.participantIdentity ?? metadata.resourceId ?? `user-${crypto.randomUUID().slice(0, 8)}`;
+    metadata.threadId ??= roomName;
+    const token = new livekitServerSdk.AccessToken(apiKey, apiSecret, { identity, ttl: options.ttl ?? "15m" });
+    token.addGrant({
+      room: roomName,
+      roomJoin: true,
+      canPublish: true,
+      canSubscribe: true,
+      canPublishData: true,
+      canUpdateOwnMetadata: true
+    });
+    token.roomConfig = new protocol.RoomConfiguration({
+      agents: [
+        new protocol.RoomAgentDispatch({
+          agentName: options.agentName ?? chunkMWTEZOBS_cjs.DEFAULT_LIVEKIT_AGENT_NAME,
+          metadata: chunkMWTEZOBS_cjs.serializeSessionMetadata(metadata)
+        })
+      ]
+    });
+    const details = {
+      serverUrl,
+      roomName,
+      participantName: identity,
+      participantToken: await token.toJwt()
+    };
+    return c.json(details);
+  };
+  return {
+    path: options.path ?? "/voice/livekit/connection-details",
+    method: "POST",
+    requiresAuth: options.requiresAuth,
+    handler
+  };
+}
+function toHttpUrl(url) {
+  return url.replace(/^ws/, "http");
+}
+async function dispatchVoiceSession(options) {
+  const serverUrl = options.serverUrl ?? process.env.LIVEKIT_URL;
+  const apiKey = options.apiKey ?? process.env.LIVEKIT_API_KEY;
+  const apiSecret = options.apiSecret ?? process.env.LIVEKIT_API_SECRET;
+  if (!serverUrl) {
+    throw new Error("@mastra/livekit: set LIVEKIT_URL or pass serverUrl to dispatchVoiceSession.");
+  }
+  if (!apiKey || !apiSecret) {
+    throw new Error(
+      "@mastra/livekit: set LIVEKIT_API_KEY and LIVEKIT_API_SECRET or pass apiKey/apiSecret to dispatchVoiceSession."
+    );
+  }
+  const client = new livekitServerSdk.AgentDispatchClient(toHttpUrl(serverUrl), apiKey, apiSecret);
+  return client.createDispatch(options.roomName, options.agentName ?? chunkMWTEZOBS_cjs.DEFAULT_LIVEKIT_AGENT_NAME, {
+    metadata: chunkMWTEZOBS_cjs.serializeSessionMetadata(options.metadata ?? {})
+  });
+}
+
+Object.defineProperty(exports, "DEFAULT_LIVEKIT_AGENT_NAME", {
+  enumerable: true,
+  get: function () { return chunkMWTEZOBS_cjs.DEFAULT_LIVEKIT_AGENT_NAME; }
+});
+Object.defineProperty(exports, "pipeAgentReplyToWriter", {
+  enumerable: true,
+  get: function () { return chunkMWTEZOBS_cjs.pipeAgentReplyToWriter; }
+});
+Object.defineProperty(exports, "serializeSessionMetadata", {
+  enumerable: true,
+  get: function () { return chunkMWTEZOBS_cjs.serializeSessionMetadata; }
+});
+exports.dispatchVoiceSession = dispatchVoiceSession;
+exports.liveKitConnectionRoute = liveKitConnectionRoute;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/routes.ts","../src/dispatch.ts"],"names":["randomUUID","AccessToken","RoomConfiguration","RoomAgentDispatch","DEFAULT_LIVEKIT_AGENT_NAME","serializeSessionMetadata","AgentDispatchClient"],"mappings":"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","file":"index.cjs","sourcesContent":["import { randomUUID } from 'node:crypto';\nimport { RoomAgentDispatch, RoomConfiguration } from '@livekit/protocol';\nimport type { ContextWithMastra, ApiRoute } from '@mastra/core/server';\nimport { AccessToken } from 'livekit-server-sdk';\nimport { DEFAULT_LIVEKIT_AGENT_NAME } from './constants';\nimport { serializeSessionMetadata } from './metadata';\nimport type { LiveKitSessionMetadata } from './metadata';\n\n/** Response body of the connection-details route. Matches LiveKit's frontend starter contract. */\nexport interface LiveKitConnectionDetails {\n  serverUrl: string;\n  roomName: string;\n  participantName: string;\n  participantToken: string;\n}\n\nexport interface ConnectionRequestArgs {\n  body: Record<string, unknown>;\n  context: ContextWithMastra;\n}\n\nexport interface LiveKitConnectionRouteOptions {\n  /**\n   * Route path. Defaults to `/voice/livekit/connection-details`. Mastra reserves the\n   * `/api` prefix for built-in routes, so custom paths must not start with `/api`.\n   */\n  path?: string;\n  /** LiveKit server URL (`wss://...`). Defaults to `LIVEKIT_URL`. */\n  serverUrl?: string;\n  /** Defaults to `LIVEKIT_API_KEY`. */\n  apiKey?: string;\n  /** Defaults to `LIVEKIT_API_SECRET`. */\n  apiSecret?: string;\n  /** LiveKit agent name for explicit dispatch. Must match the worker's `agentName`. */\n  agentName?: string;\n  /** Token time-to-live. Defaults to `'15m'`. */\n  ttl?: string | number;\n  /** Defaults to `true` (Mastra custom routes require auth unless opted out). */\n  requiresAuth?: boolean;\n  roomName?: string | ((args: ConnectionRequestArgs) => string);\n  participantIdentity?: string | ((args: ConnectionRequestArgs) => string);\n  /**\n   * Session metadata delivered to the worker via agent dispatch. Defaults to passing\n   * through `agentId`, `threadId`, and `resourceId` from the request body.\n   */\n  metadata?: (args: ConnectionRequestArgs) => LiveKitSessionMetadata | Promise<LiveKitSessionMetadata>;\n}\n\nfunction stringField(body: Record<string, unknown>, key: string): string | undefined {\n  const value = body[key];\n  return typeof value === 'string' && value.length > 0 ? value : undefined;\n}\n\n/**\n * An ApiRoute for `server.apiRoutes` that mints a LiveKit access token with the Mastra\n * voice agent dispatched into the room. Frontends call it to join a voice session:\n *\n * ```ts\n * export const mastra = new Mastra({\n *   agents: { support },\n *   server: { apiRoutes: [liveKitConnectionRoute({ agentName: 'mastra-voice' })] },\n * });\n * ```\n */\nexport function liveKitConnectionRoute(options: LiveKitConnectionRouteOptions = {}): ApiRoute {\n  const handler = async (c: ContextWithMastra) => {\n    const serverUrl = options.serverUrl ?? process.env.LIVEKIT_URL;\n    const apiKey = options.apiKey ?? process.env.LIVEKIT_API_KEY;\n    const apiSecret = options.apiSecret ?? process.env.LIVEKIT_API_SECRET;\n    if (!serverUrl || !apiKey || !apiSecret) {\n      return c.json(\n        {\n          error:\n            'LiveKit is not configured. Set LIVEKIT_URL, LIVEKIT_API_KEY, and LIVEKIT_API_SECRET ' +\n            '(or pass serverUrl/apiKey/apiSecret to liveKitConnectionRoute).',\n        },\n        500,\n      );\n    }\n\n    const body: Record<string, unknown> = await c.req\n      .json()\n      .then((parsed: unknown) =>\n        parsed && typeof parsed === 'object' && !Array.isArray(parsed) ? (parsed as Record<string, unknown>) : {},\n      )\n      .catch(() => ({}));\n    const args: ConnectionRequestArgs = { body, context: c };\n\n    const metadata: LiveKitSessionMetadata = options.metadata\n      ? await options.metadata(args)\n      : {\n          agentId: stringField(body, 'agentId'),\n          threadId: stringField(body, 'threadId'),\n          resourceId: stringField(body, 'resourceId'),\n        };\n\n    const roomName =\n      typeof options.roomName === 'function'\n        ? options.roomName(args)\n        : (options.roomName ?? `mastra-voice-${randomUUID().slice(0, 8)}`);\n    const identity =\n      typeof options.participantIdentity === 'function'\n        ? options.participantIdentity(args)\n        : (options.participantIdentity ?? metadata.resourceId ?? `user-${randomUUID().slice(0, 8)}`);\n    // One memory thread per room unless the caller pins a thread explicitly.\n    metadata.threadId ??= roomName;\n\n    const token = new AccessToken(apiKey, apiSecret, { identity, ttl: options.ttl ?? '15m' });\n    token.addGrant({\n      room: roomName,\n      roomJoin: true,\n      canPublish: true,\n      canSubscribe: true,\n      canPublishData: true,\n      canUpdateOwnMetadata: true,\n    });\n    token.roomConfig = new RoomConfiguration({\n      agents: [\n        new RoomAgentDispatch({\n          agentName: options.agentName ?? DEFAULT_LIVEKIT_AGENT_NAME,\n          metadata: serializeSessionMetadata(metadata),\n        }),\n      ],\n    });\n\n    const details: LiveKitConnectionDetails = {\n      serverUrl,\n      roomName,\n      participantName: identity,\n      participantToken: await token.toJwt(),\n    };\n    return c.json(details);\n  };\n\n  return {\n    path: options.path ?? '/voice/livekit/connection-details',\n    method: 'POST',\n    requiresAuth: options.requiresAuth,\n    handler,\n  } as ApiRoute;\n}\n","import { AgentDispatchClient } from 'livekit-server-sdk';\nimport { DEFAULT_LIVEKIT_AGENT_NAME } from './constants';\nimport { serializeSessionMetadata } from './metadata';\nimport type { LiveKitSessionMetadata } from './metadata';\n\nexport interface DispatchVoiceSessionOptions {\n  /** Room to dispatch the agent into (created on demand). */\n  roomName: string;\n  /** Must match the worker's `agentName`. Defaults to `'mastra-voice'`. */\n  agentName?: string;\n  metadata?: LiveKitSessionMetadata;\n  /** Defaults to `LIVEKIT_URL`. */\n  serverUrl?: string;\n  /** Defaults to `LIVEKIT_API_KEY`. */\n  apiKey?: string;\n  /** Defaults to `LIVEKIT_API_SECRET`. */\n  apiSecret?: string;\n}\n\nfunction toHttpUrl(url: string): string {\n  return url.replace(/^ws/, 'http');\n}\n\n/**\n * Programmatically dispatches a Mastra voice agent into a LiveKit room — for\n * server-initiated sessions such as outbound calls or joining an existing room.\n */\nexport async function dispatchVoiceSession(options: DispatchVoiceSessionOptions) {\n  const serverUrl = options.serverUrl ?? process.env.LIVEKIT_URL;\n  const apiKey = options.apiKey ?? process.env.LIVEKIT_API_KEY;\n  const apiSecret = options.apiSecret ?? process.env.LIVEKIT_API_SECRET;\n  if (!serverUrl) {\n    throw new Error('@mastra/livekit: set LIVEKIT_URL or pass serverUrl to dispatchVoiceSession.');\n  }\n  if (!apiKey || !apiSecret) {\n    throw new Error(\n      '@mastra/livekit: set LIVEKIT_API_KEY and LIVEKIT_API_SECRET or pass apiKey/apiSecret to dispatchVoiceSession.',\n    );\n  }\n  const client = new AgentDispatchClient(toHttpUrl(serverUrl), apiKey, apiSecret);\n  return client.createDispatch(options.roomName, options.agentName ?? DEFAULT_LIVEKIT_AGENT_NAME, {\n    metadata: serializeSessionMetadata(options.metadata ?? {}),\n  });\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { liveKitConnectionRoute } from './routes.js';
+export type { LiveKitConnectionRouteOptions, LiveKitConnectionDetails, ConnectionRequestArgs } from './routes.js';
+export { dispatchVoiceSession } from './dispatch.js';
+export type { DispatchVoiceSessionOptions } from './dispatch.js';
+export { serializeSessionMetadata } from './metadata.js';
+export type { LiveKitSessionMetadata } from './metadata.js';
+export { pipeAgentReplyToWriter } from './workflow-generator.js';
+export type { AgentReplyStreamLike } from './workflow-generator.js';
+export { DEFAULT_LIVEKIT_AGENT_NAME } from './constants.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAClD,YAAY,EAAE,6BAA6B,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAC/G,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,YAAY,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AACtD,YAAY,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,91 @@
+import { DEFAULT_LIVEKIT_AGENT_NAME, serializeSessionMetadata } from './chunk-2E3MTAOA.js';
+export { DEFAULT_LIVEKIT_AGENT_NAME, pipeAgentReplyToWriter, serializeSessionMetadata } from './chunk-2E3MTAOA.js';
+import { randomUUID } from 'crypto';
+import { RoomConfiguration, RoomAgentDispatch } from '@livekit/protocol';
+import { AgentDispatchClient, AccessToken } from 'livekit-server-sdk';
+
+function stringField(body, key) {
+  const value = body[key];
+  return typeof value === "string" && value.length > 0 ? value : void 0;
+}
+function liveKitConnectionRoute(options = {}) {
+  const handler = async (c) => {
+    const serverUrl = options.serverUrl ?? process.env.LIVEKIT_URL;
+    const apiKey = options.apiKey ?? process.env.LIVEKIT_API_KEY;
+    const apiSecret = options.apiSecret ?? process.env.LIVEKIT_API_SECRET;
+    if (!serverUrl || !apiKey || !apiSecret) {
+      return c.json(
+        {
+          error: "LiveKit is not configured. Set LIVEKIT_URL, LIVEKIT_API_KEY, and LIVEKIT_API_SECRET (or pass serverUrl/apiKey/apiSecret to liveKitConnectionRoute)."
+        },
+        500
+      );
+    }
+    const body = await c.req.json().then(
+      (parsed) => parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {}
+    ).catch(() => ({}));
+    const args = { body, context: c };
+    const metadata = options.metadata ? await options.metadata(args) : {
+      agentId: stringField(body, "agentId"),
+      threadId: stringField(body, "threadId"),
+      resourceId: stringField(body, "resourceId")
+    };
+    const roomName = typeof options.roomName === "function" ? options.roomName(args) : options.roomName ?? `mastra-voice-${randomUUID().slice(0, 8)}`;
+    const identity = typeof options.participantIdentity === "function" ? options.participantIdentity(args) : options.participantIdentity ?? metadata.resourceId ?? `user-${randomUUID().slice(0, 8)}`;
+    metadata.threadId ??= roomName;
+    const token = new AccessToken(apiKey, apiSecret, { identity, ttl: options.ttl ?? "15m" });
+    token.addGrant({
+      room: roomName,
+      roomJoin: true,
+      canPublish: true,
+      canSubscribe: true,
+      canPublishData: true,
+      canUpdateOwnMetadata: true
+    });
+    token.roomConfig = new RoomConfiguration({
+      agents: [
+        new RoomAgentDispatch({
+          agentName: options.agentName ?? DEFAULT_LIVEKIT_AGENT_NAME,
+          metadata: serializeSessionMetadata(metadata)
+        })
+      ]
+    });
+    const details = {
+      serverUrl,
+      roomName,
+      participantName: identity,
+      participantToken: await token.toJwt()
+    };
+    return c.json(details);
+  };
+  return {
+    path: options.path ?? "/voice/livekit/connection-details",
+    method: "POST",
+    requiresAuth: options.requiresAuth,
+    handler
+  };
+}
+function toHttpUrl(url) {
+  return url.replace(/^ws/, "http");
+}
+async function dispatchVoiceSession(options) {
+  const serverUrl = options.serverUrl ?? process.env.LIVEKIT_URL;
+  const apiKey = options.apiKey ?? process.env.LIVEKIT_API_KEY;
+  const apiSecret = options.apiSecret ?? process.env.LIVEKIT_API_SECRET;
+  if (!serverUrl) {
+    throw new Error("@mastra/livekit: set LIVEKIT_URL or pass serverUrl to dispatchVoiceSession.");
+  }
+  if (!apiKey || !apiSecret) {
+    throw new Error(
+      "@mastra/livekit: set LIVEKIT_API_KEY and LIVEKIT_API_SECRET or pass apiKey/apiSecret to dispatchVoiceSession."
+    );
+  }
+  const client = new AgentDispatchClient(toHttpUrl(serverUrl), apiKey, apiSecret);
+  return client.createDispatch(options.roomName, options.agentName ?? DEFAULT_LIVEKIT_AGENT_NAME, {
+    metadata: serializeSessionMetadata(options.metadata ?? {})
+  });
+}
+
+export { dispatchVoiceSession, liveKitConnectionRoute };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map