@mastra/livekit 0.0.0 → 0.2.0

package/dist/bridge.d.ts

@@ -0,0 +1,153 @@
+import { ReadableStream } from 'node:stream/web';
+import { llm, voice } from '@livekit/agents';
+import type { Agent as MastraAgent, AgentExecutionOptionsBase } from '@mastra/core/agent';
+import type { TracingContext } from '@mastra/core/observability';
+import { RequestContext } from '@mastra/core/request-context';
+import type { VoiceTurnMessage } from './messages.js';
+export type MastraStreamOptions = Partial<AgentExecutionOptionsBase<unknown>>;
+export interface VoiceToolCall {
+    toolCallId: string;
+    toolName: string;
+    args?: unknown;
+}
+export interface MastraVoiceAgentMemory {
+    thread: string;
+    resource?: string;
+}
+/**
+ * Per-turn context handed to a {@link VoiceReplyGenerator}. LiveKit calls `llmNode` once per
+ * detected user turn; the bridge builds this context and asks the generator for the reply.
+ */
+export interface VoiceTurnContext {
+    /**
+     * The messages to generate a reply from. With Mastra Memory on, only the messages new since
+     * the agent last spoke (history comes from the thread); with memory off, the full session.
+     *
+     * For a workflow / custom generator: pass these straight to a memory-backed `agent.stream(...,
+     * { memory })` inside a step so the agent backfills history from the thread (no duplication). A
+     * stateless workflow that wants the entire transcript every turn should read `chatCtx` instead
+     * (e.g. `chatContextToMessages(chatCtx)`), since there is no thread to backfill from.
+     */
+    messages: VoiceTurnMessage[];
+    /** The raw LiveKit chat context, for generators that want the full transcript or message parts. */
+    chatCtx: llm.ChatContext;
+    /** Resolved memory mapping for the call, or `false` when memory is disabled. */
+    memory: MastraVoiceAgentMemory | false;
+    /** Request context forwarded to generation. */
+    requestContext?: RequestContext;
+    /** Voice-call span context, so each turn's generation nests under the call trace. */
+    tracingContext?: TracingContext;
+}
+/**
+ * What a turn produced, handed to {@link VoiceTurnCompleteHook} after the reply finishes.
+ */
+export interface VoiceTurnResult {
+    /** The assistant reply text streamed this turn, accumulated from the model's text deltas. */
+    text: string;
+    /** Tool calls the agent made during the turn, in order. */
+    toolCalls: VoiceToolCall[];
+    /** True when barge-in cut the turn short before it finished streaming. */
+    interrupted: boolean;
+}
+/** {@link VoiceTurnContext} plus the reply it produced. Passed to {@link VoiceTurnCompleteHook}. */
+export interface VoiceTurnCompleteContext extends VoiceTurnContext {
+    /** The reply the agent produced this turn. */
+    result: VoiceTurnResult;
+}
+/**
+ * Called once per turn AFTER the reply has finished streaming to text-to-speech — off the audio
+ * path. It runs fire-and-forget: the turn does not await it, so post-turn work (memory
+ * maintenance, CRM writes, analytics) never delays what the caller hears or the next turn. A
+ * thrown error or rejected promise is logged, not propagated. Because the resolved `memory`
+ * mapping (`thread`/`resource`) is on the context, this is the place for a truly non-blocking
+ * `memory.updateWorkingMemory(...)`. See {@link MastraVoiceAgentOptions.onTurnComplete}.
+ */
+export type VoiceTurnCompleteHook = (ctx: VoiceTurnCompleteContext) => void | Promise<void>;
+/**
+ * Produces a stream of text deltas for one conversational turn, or `null` to stay silent.
+ * Cancelling the returned stream (LiveKit does this on barge-in) must abort the underlying
+ * generation. Built-in implementations: {@link createAgentReplyGenerator} (a Mastra agent) and
+ * `createWorkflowReplyGenerator` (a Mastra workflow).
+ */
+export type VoiceReplyGenerator = (ctx: VoiceTurnContext) => ReadableStream<string> | null | Promise<ReadableStream<string> | null>;
+export interface AgentReplyGeneratorOptions {
+    /** The Mastra agent that generates replies. Tools and memory run inside this agent. */
+    agent: MastraAgent;
+    /** Extra options merged into every `agent.stream()` call (e.g. `tracingContext`). */
+    streamOptions?: MastraStreamOptions;
+    /** Speak a short phrase while a tool call runs. See {@link MastraVoiceAgentOptions.toolFeedback}. */
+    toolFeedback?: (toolCall: VoiceToolCall) => string | undefined | void;
+    /** Fired off the audio path after the reply streams. See {@link MastraVoiceAgentOptions.onTurnComplete}. */
+    onTurnComplete?: VoiceTurnCompleteHook;
+}
+/**
+ * A {@link VoiceReplyGenerator} backed by a Mastra agent: runs the agent's full loop (model,
+ * tools, memory) and streams its text deltas. On barge-in the returned stream is cancelled,
+ * which aborts the in-flight `agent.stream()`.
+ */
+export declare function createAgentReplyGenerator(options: AgentReplyGeneratorOptions): VoiceReplyGenerator;
+export interface MastraVoiceAgentOptions {
+    /**
+     * The Mastra agent that generates replies. Tools and memory run inside this agent. Provide
+     * either this or {@link MastraVoiceAgentOptions.generate}.
+     */
+    agent?: MastraAgent;
+    /**
+     * A lower-level reply generator (e.g. from `createWorkflowReplyGenerator`). Use instead of
+     * `agent` to drive replies with a workflow or any custom generator.
+     */
+    generate?: VoiceReplyGenerator;
+    /**
+     * Conversation persistence. When set, only messages new since the agent last spoke are
+     * sent each turn and Mastra Memory supplies history. When `false`, the full LiveKit
+     * in-session context is sent on every turn instead.
+     */
+    memory?: MastraVoiceAgentMemory | false;
+    /** Request context entries forwarded to generation. */
+    requestContext?: RequestContext | Record<string, unknown>;
+    /**
+     * Called when the Mastra agent starts a tool call mid-reply. Return a short phrase (e.g. "Let
+     * me look that up.") to speak it while the tool runs; it also appears in the transcript. Return
+     * nothing to stay silent. Applies to the agent generator built here; the workflow generator
+     * takes its own equivalent via `createWorkflowReplyGenerator`.
+     */
+    toolFeedback?: (toolCall: VoiceToolCall) => string | undefined | void;
+    /**
+     * Called once per turn after the reply has finished streaming to text-to-speech. Runs off the
+     * audio path and fire-and-forget — the turn does not await it — so post-turn memory
+     * maintenance, CRM writes, or analytics never delay the caller or the next turn. The context
+     * carries the produced reply ({@link VoiceTurnResult}) and the resolved `memory` mapping, so
+     * this is where a truly non-blocking `memory.updateWorkingMemory(...)` belongs. A thrown error
+     * or rejected promise is logged, not propagated. Applies to the agent generator built here; the
+     * workflow generator takes its own via `createWorkflowReplyGenerator`.
+     */
+    onTurnComplete?: VoiceTurnCompleteHook;
+    /** Extra options merged into every `agent.stream()` call (agent generator only). */
+    streamOptions?: MastraStreamOptions;
+    /** LiveKit agent instructions. Unused for reply generation (the Mastra agent/workflow applies its own). */
+    instructions?: string;
+    id?: voice.AgentOptions<unknown>['id'];
+    stt?: voice.AgentOptions<unknown>['stt'];
+    vad?: voice.AgentOptions<unknown>['vad'];
+    tts?: voice.AgentOptions<unknown>['tts'];
+    turnHandling?: voice.AgentOptions<unknown>['turnHandling'];
+}
+/**
+ * A LiveKit `voice.Agent` whose replies come from a Mastra agent or workflow.
+ *
+ * LiveKit keeps ownership of the audio loop (VAD, STT, turn detection, TTS, barge-in) and calls
+ * `llmNode` once per detected user turn; the node delegates to a {@link VoiceReplyGenerator}
+ * which streams text deltas back. On barge-in LiveKit cancels the returned stream, which aborts
+ * the in-flight generation.
+ */
+export declare class MastraVoiceAgent extends voice.Agent {
+    readonly mastraAgent?: MastraAgent;
+    readonly memory: MastraVoiceAgentMemory | false;
+    readonly requestContext?: RequestContext;
+    readonly streamOptions?: MastraStreamOptions;
+    private readonly replyGenerator;
+    constructor(options: MastraVoiceAgentOptions);
+    llmNode(chatCtx: llm.ChatContext, _toolCtx: llm.ToolContext, _modelSettings: voice.ModelSettings): Promise<ReadableStream<llm.ChatChunk | string> | null>;
+}
+export declare function createMastraVoiceAgent(options: MastraVoiceAgentOptions): MastraVoiceAgent;
+//# sourceMappingURL=bridge.d.ts.map

package/dist/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"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"}

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