@mastra/livekit 0.0.0 → 0.2.0-alpha.0

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/routes.ts","../src/dispatch.ts"],"names":[],"mappings":";;;;;;AAgDA,SAAS,WAAA,CAAY,MAA+B,GAAA,EAAiC;AACnF,EAAA,MAAM,KAAA,GAAQ,KAAK,GAAG,CAAA;AACtB,EAAA,OAAO,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,CAAM,MAAA,GAAS,IAAI,KAAA,GAAQ,MAAA;AACjE;AAaO,SAAS,sBAAA,CAAuB,OAAA,GAAyC,EAAC,EAAa;AAC5F,EAAA,MAAM,OAAA,GAAU,OAAO,CAAA,KAAyB;AAC9C,IAAA,MAAM,SAAA,GAAY,OAAA,CAAQ,SAAA,IAAa,OAAA,CAAQ,GAAA,CAAI,WAAA;AACnD,IAAA,MAAM,MAAA,GAAS,OAAA,CAAQ,MAAA,IAAU,OAAA,CAAQ,GAAA,CAAI,eAAA;AAC7C,IAAA,MAAM,SAAA,GAAY,OAAA,CAAQ,SAAA,IAAa,OAAA,CAAQ,GAAA,CAAI,kBAAA;AACnD,IAAA,IAAI,CAAC,SAAA,IAAa,CAAC,MAAA,IAAU,CAAC,SAAA,EAAW;AACvC,MAAA,OAAO,CAAA,CAAE,IAAA;AAAA,QACP;AAAA,UACE,KAAA,EACE;AAAA,SAEJ;AAAA,QACA;AAAA,OACF;AAAA,IACF;AAEA,IAAA,MAAM,IAAA,GAAgC,MAAM,CAAA,CAAE,GAAA,CAC3C,MAAK,CACL,IAAA;AAAA,MAAK,CAAC,MAAA,KACL,MAAA,IAAU,OAAO,MAAA,KAAW,QAAA,IAAY,CAAC,KAAA,CAAM,OAAA,CAAQ,MAAM,CAAA,GAAK,MAAA,GAAqC;AAAC,KAC1G,CACC,KAAA,CAAM,OAAO,EAAC,CAAE,CAAA;AACnB,IAAA,MAAM,IAAA,GAA8B,EAAE,IAAA,EAAM,OAAA,EAAS,CAAA,EAAE;AAEvD,IAAA,MAAM,WAAmC,OAAA,CAAQ,QAAA,GAC7C,MAAM,OAAA,CAAQ,QAAA,CAAS,IAAI,CAAA,GAC3B;AAAA,MACE,OAAA,EAAS,WAAA,CAAY,IAAA,EAAM,SAAS,CAAA;AAAA,MACpC,QAAA,EAAU,WAAA,CAAY,IAAA,EAAM,UAAU,CAAA;AAAA,MACtC,UAAA,EAAY,WAAA,CAAY,IAAA,EAAM,YAAY;AAAA,KAC5C;AAEJ,IAAA,MAAM,WACJ,OAAO,OAAA,CAAQ,QAAA,KAAa,UAAA,GACxB,QAAQ,QAAA,CAAS,IAAI,CAAA,GACpB,OAAA,CAAQ,YAAY,CAAA,aAAA,EAAgB,UAAA,GAAa,KAAA,CAAM,CAAA,EAAG,CAAC,CAAC,CAAA,CAAA;AACnE,IAAA,MAAM,WACJ,OAAO,OAAA,CAAQ,wBAAwB,UAAA,GACnC,OAAA,CAAQ,oBAAoB,IAAI,CAAA,GAC/B,QAAQ,mBAAA,IAAuB,QAAA,CAAS,cAAc,CAAA,KAAA,EAAQ,UAAA,GAAa,KAAA,CAAM,CAAA,EAAG,CAAC,CAAC,CAAA,CAAA;AAE7F,IAAA,QAAA,CAAS,QAAA,KAAa,QAAA;AAEtB,IAAA,MAAM,KAAA,GAAQ,IAAI,WAAA,CAAY,MAAA,EAAQ,SAAA,EAAW,EAAE,QAAA,EAAU,GAAA,EAAK,OAAA,CAAQ,GAAA,IAAO,KAAA,EAAO,CAAA;AACxF,IAAA,KAAA,CAAM,QAAA,CAAS;AAAA,MACb,IAAA,EAAM,QAAA;AAAA,MACN,QAAA,EAAU,IAAA;AAAA,MACV,UAAA,EAAY,IAAA;AAAA,MACZ,YAAA,EAAc,IAAA;AAAA,MACd,cAAA,EAAgB,IAAA;AAAA,MAChB,oBAAA,EAAsB;AAAA,KACvB,CAAA;AACD,IAAA,KAAA,CAAM,UAAA,GAAa,IAAI,iBAAA,CAAkB;AAAA,MACvC,MAAA,EAAQ;AAAA,QACN,IAAI,iBAAA,CAAkB;AAAA,UACpB,SAAA,EAAW,QAAQ,SAAA,IAAa,0BAAA;AAAA,UAChC,QAAA,EAAU,yBAAyB,QAAQ;AAAA,SAC5C;AAAA;AACH,KACD,CAAA;AAED,IAAA,MAAM,OAAA,GAAoC;AAAA,MACxC,SAAA;AAAA,MACA,QAAA;AAAA,MACA,eAAA,EAAiB,QAAA;AAAA,MACjB,gBAAA,EAAkB,MAAM,KAAA,CAAM,KAAA;AAAM,KACtC;AACA,IAAA,OAAO,CAAA,CAAE,KAAK,OAAO,CAAA;AAAA,EACvB,CAAA;AAEA,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,QAAQ,IAAA,IAAQ,mCAAA;AAAA,IACtB,MAAA,EAAQ,MAAA;AAAA,IACR,cAAc,OAAA,CAAQ,YAAA;AAAA,IACtB;AAAA,GACF;AACF;ACzHA,SAAS,UAAU,GAAA,EAAqB;AACtC,EAAA,OAAO,GAAA,CAAI,OAAA,CAAQ,KAAA,EAAO,MAAM,CAAA;AAClC;AAMA,eAAsB,qBAAqB,OAAA,EAAsC;AAC/E,EAAA,MAAM,SAAA,GAAY,OAAA,CAAQ,SAAA,IAAa,OAAA,CAAQ,GAAA,CAAI,WAAA;AACnD,EAAA,MAAM,MAAA,GAAS,OAAA,CAAQ,MAAA,IAAU,OAAA,CAAQ,GAAA,CAAI,eAAA;AAC7C,EAAA,MAAM,SAAA,GAAY,OAAA,CAAQ,SAAA,IAAa,OAAA,CAAQ,GAAA,CAAI,kBAAA;AACnD,EAAA,IAAI,CAAC,SAAA,EAAW;AACd,IAAA,MAAM,IAAI,MAAM,6EAA6E,CAAA;AAAA,EAC/F;AACA,EAAA,IAAI,CAAC,MAAA,IAAU,CAAC,SAAA,EAAW;AACzB,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KACF;AAAA,EACF;AACA,EAAA,MAAM,SAAS,IAAI,mBAAA,CAAoB,UAAU,SAAS,CAAA,EAAG,QAAQ,SAAS,CAAA;AAC9E,EAAA,OAAO,OAAO,cAAA,CAAe,OAAA,CAAQ,QAAA,EAAU,OAAA,CAAQ,aAAa,0BAAA,EAA4B;AAAA,IAC9F,QAAA,EAAU,wBAAA,CAAyB,OAAA,CAAQ,QAAA,IAAY,EAAE;AAAA,GAC1D,CAAA;AACH","file":"index.js","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/messages.d.ts

@@ -0,0 +1,24 @@
+import type { llm } from '@livekit/agents';
+export type VoiceTurnMessage = {
+    role: 'system';
+    content: string;
+} | {
+    role: 'user';
+    content: string;
+} | {
+    role: 'assistant';
+    content: string;
+};
+/**
+ * Extracts only the messages added since the agent last spoke. Used when Mastra Memory is
+ * the source of truth for conversation history: prior turns are already persisted in the
+ * thread, so re-sending them would duplicate history.
+ */
+export declare function extractNewTurnMessages(chatCtx: llm.ChatContext): VoiceTurnMessage[];
+/**
+ * Converts the full LiveKit chat context to Mastra messages. Used when the bridge runs
+ * without Mastra Memory and LiveKit's in-session context is the only history. The agent's
+ * LiveKit-level instructions are excluded — the Mastra agent applies its own instructions.
+ */
+export declare function chatContextToMessages(chatCtx: llm.ChatContext): VoiceTurnMessage[];
+//# sourceMappingURL=messages.d.ts.map

package/dist/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAE3C,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AA0B3C;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,GAAG,CAAC,WAAW,GAAG,gBAAgB,EAAE,CAgBnF;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,GAAG,CAAC,WAAW,GAAG,gBAAgB,EAAE,CAQlF"}

package/dist/metadata.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Session metadata passed from the Mastra server to the LiveKit agent worker through
+ * LiveKit's job dispatch metadata (a plain string, so this is JSON-serialized).
+ */
+export interface LiveKitSessionMetadata {
+    /** Mastra agent to run, by registered key or agent id. */
+    agentId?: string;
+    /** Memory thread id. Defaults to the LiveKit room name when omitted. */
+    threadId?: string;
+    /** Memory resource id (typically the end user id). */
+    resourceId?: string;
+    /** Plain-object entries restored into a RequestContext for agent execution. */
+    requestContext?: Record<string, unknown>;
+}
+export declare function parseSessionMetadata(raw: string | undefined | null): LiveKitSessionMetadata;
+export declare function serializeSessionMetadata(metadata: LiveKitSessionMetadata): string;
+//# sourceMappingURL=metadata.d.ts.map

package/dist/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+EAA+E;IAC/E,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,sBAAsB,CAW3F;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,MAAM,CAEjF"}

package/dist/observability.d.ts

@@ -0,0 +1,46 @@
+import { voice } from '@livekit/agents';
+import type { Mastra } from '@mastra/core/mastra';
+import { SpanType } from '@mastra/core/observability';
+import type { Span, TracingContext } from '@mastra/core/observability';
+import type { RequestContext } from '@mastra/core/request-context';
+import type { LiveKitSessionMetadata } from './metadata.js';
+export interface VoiceCallObservabilityOptions {
+    /** The Mastra instance whose observability config receives the spans. */
+    mastra: Mastra;
+    /** Resolved Mastra agent id/key answering the call (for span attribution). */
+    agentId: string;
+    /** LiveKit room name for this session. */
+    roomName: string;
+    /** Dispatch metadata for the session. */
+    metadata: LiveKitSessionMetadata;
+    /** Request context forwarded to span sampling. */
+    requestContext?: RequestContext;
+}
+export interface VoiceCallObservability {
+    /** The root `voice call` span. Each turn's agent run and every pipeline metric nests under it. */
+    readonly span: Span<SpanType.GENERIC>;
+    /** Thread into the bridge's `streamOptions` so each turn's agent run nests under the call. */
+    readonly tracingContext: TracingContext;
+    /** Subscribe to the session's `metrics_collected` events. Call once, before `session.start()`. */
+    attach(session: voice.AgentSession): void;
+    /** Close the call span with the usage roll-up. Idempotent; safe to call from a shutdown hook. */
+    finalize(options?: {
+        error?: unknown;
+    }): void;
+}
+/**
+ * Opens a `voice call` trace for one LiveKit session and bridges LiveKit's voice-pipeline
+ * metrics into Mastra observability.
+ *
+ * The returned root span groups everything about the call: each conversation turn's Mastra
+ * agent run (nested via {@link VoiceCallObservability.tracingContext}) plus an event span for
+ * every STT, TTS, end-of-utterance, VAD, and LLM-latency metric LiveKit emits. Metrics are
+ * point-in-time, so they're recorded as event spans (no duration) with the value in the name.
+ * The root closes on the session `close` event with a per-model usage roll-up (token, character,
+ * and audio totals for the whole call) from a `ModelUsageCollector`.
+ *
+ * Returns `undefined` when the Mastra instance has no observability configured, so callers
+ * can treat instrumentation as a no-op without branching on config.
+ */
+export declare function startVoiceCallObservability(options: VoiceCallObservabilityOptions): VoiceCallObservability | undefined;
+//# sourceMappingURL=observability.d.ts.map

package/dist/observability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability.d.ts","sourceRoot":"","sources":["../src/observability.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAmB,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD,MAAM,WAAW,6BAA6B;IAC5C,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,QAAQ,EAAE,sBAAsB,CAAC;IACjC,kDAAkD;IAClD,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,MAAM,WAAW,sBAAsB;IACrC,kGAAkG;IAClG,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACtC,8FAA8F;IAC9F,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,kGAAkG;IAClG,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC;IAC1C,iGAAiG;IACjG,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;CAC/C;AAgGD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,6BAA6B,GACrC,sBAAsB,GAAG,SAAS,CAsDpC"}

package/dist/routes.d.ts

@@ -0,0 +1,52 @@
+import type { ContextWithMastra, ApiRoute } from '@mastra/core/server';
+import type { LiveKitSessionMetadata } from './metadata.js';
+/** Response body of the connection-details route. Matches LiveKit's frontend starter contract. */
+export interface LiveKitConnectionDetails {
+    serverUrl: string;
+    roomName: string;
+    participantName: string;
+    participantToken: string;
+}
+export interface ConnectionRequestArgs {
+    body: Record<string, unknown>;
+    context: ContextWithMastra;
+}
+export interface LiveKitConnectionRouteOptions {
+    /**
+     * Route path. Defaults to `/voice/livekit/connection-details`. Mastra reserves the
+     * `/api` prefix for built-in routes, so custom paths must not start with `/api`.
+     */
+    path?: string;
+    /** LiveKit server URL (`wss://...`). Defaults to `LIVEKIT_URL`. */
+    serverUrl?: string;
+    /** Defaults to `LIVEKIT_API_KEY`. */
+    apiKey?: string;
+    /** Defaults to `LIVEKIT_API_SECRET`. */
+    apiSecret?: string;
+    /** LiveKit agent name for explicit dispatch. Must match the worker's `agentName`. */
+    agentName?: string;
+    /** Token time-to-live. Defaults to `'15m'`. */
+    ttl?: string | number;
+    /** Defaults to `true` (Mastra custom routes require auth unless opted out). */
+    requiresAuth?: boolean;
+    roomName?: string | ((args: ConnectionRequestArgs) => string);
+    participantIdentity?: string | ((args: ConnectionRequestArgs) => string);
+    /**
+     * Session metadata delivered to the worker via agent dispatch. Defaults to passing
+     * through `agentId`, `threadId`, and `resourceId` from the request body.
+     */
+    metadata?: (args: ConnectionRequestArgs) => LiveKitSessionMetadata | Promise<LiveKitSessionMetadata>;
+}
+/**
+ * An ApiRoute for `server.apiRoutes` that mints a LiveKit access token with the Mastra
+ * voice agent dispatched into the room. Frontends call it to join a voice session:
+ *
+ * ```ts
+ * export const mastra = new Mastra({
+ *   agents: { support },
+ *   server: { apiRoutes: [liveKitConnectionRoute({ agentName: 'mastra-voice' })] },
+ * });
+ * ```
+ */
+export declare function liveKitConnectionRoute(options?: LiveKitConnectionRouteOptions): ApiRoute;
+//# sourceMappingURL=routes.d.ts.map

package/dist/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAIvE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD,kGAAkG;AAClG,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,OAAO,EAAE,iBAAiB,CAAC;CAC5B;AAED,MAAM,WAAW,6BAA6B;IAC5C;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qFAAqF;IACrF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,+EAA+E;IAC/E,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,qBAAqB,KAAK,MAAM,CAAC,CAAC;IAC9D,mBAAmB,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,qBAAqB,KAAK,MAAM,CAAC,CAAC;IACzE;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,qBAAqB,KAAK,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACtG;AAOD;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,6BAAkC,GAAG,QAAQ,CA4E5F"}

package/dist/run.d.ts

@@ -0,0 +1,32 @@
+import { ServerOptions } from '@livekit/agents';
+export interface RunLiveKitWorkerOptions {
+    /** The worker entry module whose default export is the agent definition. Pass `import.meta.url`. */
+    entry: string | URL;
+    /** LiveKit agent name for explicit dispatch. Defaults to `'mastra-voice'`. */
+    agentName?: string;
+    /** Extra LiveKit ServerOptions merged over what this helper builds. */
+    serverOptions?: Partial<ConstructorParameters<typeof ServerOptions>[0]>;
+}
+export declare function resolveWorkerEntryPath(entry: string | URL): string;
+/**
+ * Starts the LiveKit agent worker CLI (`dev` / `start` / `connect` subcommands) for a
+ * worker entry file. Call it from the same file that default-exports
+ * {@link createLiveKitWorker}, guarded so it only runs when executed directly:
+ *
+ * ```ts
+ * import { fileURLToPath } from 'node:url';
+ * import { createLiveKitWorker, runLiveKitWorker } from '@mastra/livekit/worker';
+ * import { mastra } from './index.js';
+ *
+ * export default createLiveKitWorker({ mastra, agent: 'support' });
+ *
+ * if (process.argv[1] === fileURLToPath(import.meta.url)) {
+ *   runLiveKitWorker({ entry: import.meta.url, agentName: 'mastra-voice' });
+ * }
+ * ```
+ *
+ * Using this helper (instead of `cli.runApp` from `@livekit/agents`) guarantees the worker
+ * runtime and the bridge share one copy of the LiveKit SDK.
+ */
+export declare function runLiveKitWorker(options: RunLiveKitWorkerOptions): void;
+//# sourceMappingURL=run.d.ts.map

package/dist/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AACA,OAAO,EAAO,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAIrD,MAAM,WAAW,uBAAuB;IACtC,oGAAoG;IACpG,KAAK,EAAE,MAAM,GAAG,GAAG,CAAC;IACpB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,aAAa,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACzE;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,MAAM,CAGlE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAYvE"}

package/dist/voice-thread.d.ts

@@ -0,0 +1,23 @@
+import type { MastraMemory } from '@mastra/core/memory';
+export interface VoiceThreadArgs {
+    memory: MastraMemory;
+    threadId: string;
+    resourceId: string;
+}
+/**
+ * Creates the call's memory thread up front when it doesn't exist yet, titled and tagged
+ * so it reads as a voice call in Studio's thread list instead of an untitled thread that
+ * only appears after the first exchange.
+ */
+export declare function ensureVoiceCallThread({ memory, threadId, resourceId, roomName, }: VoiceThreadArgs & {
+    roomName: string;
+}): Promise<void>;
+/**
+ * Persists the spoken greeting as an assistant message. The greeting is spoken via TTS
+ * without going through the Mastra agent, so without this the saved thread would start
+ * at the caller's first words instead of being a faithful call transcript.
+ */
+export declare function persistSpokenGreeting({ memory, threadId, resourceId, greeting, }: VoiceThreadArgs & {
+    greeting: string;
+}): Promise<void>;
+//# sourceMappingURL=voice-thread.d.ts.map

package/dist/voice-thread.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-thread.d.ts","sourceRoot":"","sources":["../src/voice-thread.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,EAC1C,MAAM,EACN,QAAQ,EACR,UAAU,EACV,QAAQ,GACT,EAAE,eAAe,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CASxD;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,EAC1C,MAAM,EACN,QAAQ,EACR,UAAU,EACV,QAAQ,GACT,EAAE,eAAe,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBxD"}