@mastra/livekit 0.2.0 → 0.3.0

package/dist/worker.d.ts

@@ -36,6 +36,12 @@ export interface VoiceCallEndArgs {
     metadata: LiveKitSessionMetadata;
     /** Request context for the call, if any. */
     requestContext?: RequestContext;
+    /**
+     * The worker's `configuration` (greeting, consent requirements, …). Read it here to honor policy
+     * at end-of-call — e.g. only flush a call summary to observational memory when
+     * `configuration.consentPolicy.summaryStorage` isn't required, or the caller granted it.
+     */
+    configuration?: LiveKitWorkerConfiguration;
     /** The LiveKit room name. */
     roomName: string;
     /** The LiveKit job context, for advanced teardown needs. */
@@ -77,9 +83,17 @@ export interface CreateLiveKitWorkerOptions {
     resultText?: (result: unknown) => string | undefined | void;
     /** Lowest-level escape hatch: supply any reply generator directly (a custom workflow, remote bridge, …). */
     generate?: VoiceReplyGenerator;
-    /** Speech-to-text: a LiveKit plugin instance or an inference model string like 'deepgram/nova-3'. */
+    /**
+     * Speech-to-text: a LiveKit plugin instance or an inference model string like 'deepgram/nova-3'.
+     * For per-call / per-tenant selection, set the `configuration.stt` resolver — it takes
+     * precedence, with this option as the fallback.
+     */
     stt?: voice.AgentSessionOptions['stt'];
-    /** Text-to-speech: a LiveKit plugin instance or an inference model string like 'cartesia/sonic-3'. */
+    /**
+     * Text-to-speech: a LiveKit plugin instance or an inference model string like 'cartesia/sonic-3'.
+     * For per-call / per-tenant selection, set the `configuration.tts` resolver — it takes
+     * precedence, with this option as the fallback.
+     */
     tts?: voice.AgentSessionOptions['tts'];
     /**
      * Voice activity detection. `'silero'` (default) loads the Silero VAD from
@@ -136,12 +150,25 @@ export interface CreateLiveKitWorkerOptions {
      * grace window; a thrown error is logged, not propagated. See {@link VoiceCallEndArgs}.
      */
     onCallEnd?: VoiceCallEndHook;
-    /** Static greeting spoken when the session starts. */
+    /**
+     * Grouped conversation & compliance configuration. Related policy knobs live here — rather than
+     * as many top-level worker options — so this call stays flat as more are added. Today it carries
+     * the greeting / AI-disclosure; it's the intended home for further compliance controls (recording
+     * notice, periodic re-disclosure, data retention, human handoff, …). See
+     * {@link LiveKitWorkerConfiguration}.
+     */
+    configuration?: LiveKitWorkerConfiguration;
+    /**
+     * Static greeting spoken when the session starts.
+     *
+     * @deprecated Prefer `configuration.greeting.text`. Still honored for backwards compatibility;
+     * when `configuration.greeting` is also set, its fields take precedence.
+     */
     greeting?: string;
     /**
-     * Save the spoken greeting to the memory thread as an assistant message, so the saved
-     * thread is a faithful call transcript. Defaults to `true`; only applies when a
-     * greeting is set and memory is enabled.
+     * Save the spoken greeting to the memory thread as an assistant message.
+     *
+     * @deprecated Prefer `configuration.greeting.persist`. Still honored for backwards compatibility.
      */
     persistGreeting?: boolean;
     /**
@@ -158,6 +185,253 @@ export interface CreateLiveKitWorkerOptions {
 }
 export declare function resolveMemoryInstance(options: Pick<CreateLiveKitWorkerOptions, 'memoryInstance' | 'mastra'>, mastraAgent: MastraAgent | undefined, args: ResolveMastraAgentArgs, requestContext: RequestContext | undefined): Promise<MastraMemory | null>;
 export declare function buildTurnHandling(options: Pick<CreateLiveKitWorkerOptions, 'turnHandling'>, turnDetection: TurnDetectionSetting | undefined): voice.AgentSessionOptions['turnHandling'];
+/**
+ * Per-call context handed to the `configuration` resolvers (greeting text, STT, TTS) so they can
+ * key per-call / per-tenant behavior off the call. Built post-connect, so the dispatch metadata,
+ * request context, and room name are all available.
+ */
+export interface VoiceCallContext {
+    /**
+     * Dispatch metadata for the call — the per-tenant routing signal (dialed number, tenant/agent id,
+     * thread/resource, and any `requestContext` entries) parsed from the LiveKit job metadata.
+     */
+    metadata: LiveKitSessionMetadata;
+    /** The request context built from the dispatch metadata, if any. */
+    requestContext?: RequestContext;
+    /** The LiveKit room name. */
+    roomName: string;
+    /** The LiveKit job context, for anything the metadata doesn't carry. */
+    ctx: JobContext;
+}
+/** Context handed to a greeting resolver. Alias of {@link VoiceCallContext}. */
+export type GreetingContext = VoiceCallContext;
+/**
+ * A per-call resolver for a session component (STT / TTS): invoked once per call (post-connect)
+ * with the call {@link VoiceCallContext}. Return `undefined` to fall back to the static top-level
+ * option for that component.
+ */
+export type SessionComponentResolver<T> = (context: VoiceCallContext) => T | undefined | void | Promise<T | undefined | void>;
+/**
+ * The spoken greeting: a fixed string, or a resolver invoked once per call (post-connect) with the
+ * call {@link GreetingContext}. Use the resolver form for a per-tenant greeting derived from the
+ * dispatch metadata / request context — one multi-tenant agent, a different opening per tenant.
+ * Return `undefined` (or empty) for no greeting on that call.
+ */
+export type GreetingText = string | ((context: GreetingContext) => string | undefined | void | Promise<string | undefined | void>);
+/**
+ * The opening greeting spoken when the session starts — and the vehicle for a required AI
+ * disclosure. Under the EU AI Act (Art. 50) a person interacting with an AI system must be told so
+ * at the first interaction; set `allowInterruptions: false` so that disclosure can't be talked over.
+ */
+export interface GreetingConfiguration {
+    /**
+     * What is spoken when the session starts. A fixed string, or a resolver invoked once per call
+     * (post-connect) with the call {@link GreetingContext} — return a per-tenant greeting built from
+     * the dispatch metadata / request context (e.g. `` `Thanks for calling ${tenant}, you're speaking
+     * with an AI assistant` ``). Omit, or return `undefined`, for no greeting.
+     */
+    text?: GreetingText;
+    /**
+     * Whether the caller can interrupt (barge over) the greeting. Defaults to LiveKit's behavior
+     * (interruptible). Set `false` to make the greeting play through — e.g. when it carries a
+     * disclosure the caller is legally required to hear ("you're speaking with an AI assistant"),
+     * so they can't talk over it and miss it.
+     */
+    allowInterruptions?: boolean;
+    /**
+     * Wait for the greeting to finish playing before continuing (greeting persistence and
+     * `onSessionStart`). Defaults to `false`. Pair with `allowInterruptions: false` when a
+     * disclosure must fully play out before any post-greeting work runs.
+     */
+    awaitPlayout?: boolean;
+    /**
+     * Save the spoken greeting to the memory thread as an assistant message, so the saved thread is
+     * a faithful call transcript. Defaults to `true`; only applies when memory is enabled.
+     */
+    persist?: boolean;
+    /**
+     * Periodically re-disclose the AI status on long calls (e.g. California SB 243). Once this many
+     * milliseconds have elapsed since the last disclosure, the next turn's reply is prefixed with a
+     * short reminder — spoken at the turn boundary, never mid-turn. Omit (or `0`) to disable. Example:
+     * `repeatEvery: 3 * 60_000` re-discloses roughly every three minutes.
+     *
+     * CAVEAT: don't combine with `turnHandling.preemptiveGeneration`. The reminder clock resets when
+     * the reminder is threaded into a reply stream; a speculative reply that gets discarded still
+     * consumes the interval, so the next real turn can miss its re-disclosure. (Preemptive
+     * generation is off by default and already incompatible with memory on this path.)
+     */
+    repeatEvery?: number;
+    /** The short reminder spoken on each re-disclosure. Defaults to a generic AI-assistant reminder. */
+    repeatText?: string;
+}
+/**
+ * One consent item's requirement. `true` is shorthand for a required consent with defaults; the
+ * object form carries the metadata a production consent record needs (whether it's required, and a
+ * human-readable purpose for the spoken/logged prompt and the audit trail).
+ */
+export type ConsentRequirement = boolean | {
+    /** Whether the caller's consent is required for this item. Defaults to `true` when present. */
+    required?: boolean;
+    /**
+     * Human-readable description of what is being consented to — for the spoken/logged consent
+     * prompt and the stored consent record. E.g. "storing a summary of this call".
+     */
+    purpose?: string;
+};
+/**
+ * The call's consent policy, as a **named, extensible set** — each item independently required
+ * and independently granted at runtime, rather than one global "consented" flag. New consent
+ * items are added as named keys so the model grows without reshaping existing ones or conflating
+ * unrelated permissions (a production consent model, not one-size-fits-all). Declaring a policy
+ * enforces nothing by itself: capture the caller's grant at runtime with `createConsentTool`, and
+ * enforce it in your own code (at `onCallEnd`, or before any consent-gated action).
+ */
+export interface ConsentConfiguration {
+    /**
+     * Consent to store a summary of the call (observational-memory distillation, CRM notes, etc.).
+     * When required, persist a call summary only if the caller has granted this consent.
+     */
+    summaryStorage?: ConsentRequirement;
+}
+/**
+ * Agent-initiated hang-up: let the agent end the call itself (say goodbye → hang up). Enable it here
+ * and add a matching tool to the agent with `createEndCallTool` (both default to the tool name
+ * `'endCall'`). The tool only signals intent — from inside `agent.stream()` it can't reach the room;
+ * the worker owns the hang-up. On each turn the worker watches for the tool, waits for the agent's
+ * closing words to finish playing (so the goodbye is never cut off), then disconnects — running
+ * `onCallEnd` on the way out, exactly as a caller-initiated hang-up does. Works on the agent and
+ * workflow reply paths.
+ */
+export interface EndCallConfiguration {
+    /**
+     * Name of the tool the agent calls to end the call — must match the `id` you gave
+     * `createEndCallTool`. Defaults to `'endCall'`.
+     */
+    tool?: string;
+    /**
+     * Optional closing line spoken (non-interruptibly) right before hanging up, after the agent's own
+     * final words finish. Use it for a guaranteed sign-off or a compliance closing. Omit to just hang
+     * up once the agent's closing words finish playing.
+     */
+    message?: string;
+    /** Reason recorded on the shutdown (shows up in LiveKit logs). Defaults to `'agent ended call'`. */
+    reason?: string;
+    /**
+     * Extra drain time in milliseconds between the closing words finishing and the room being
+     * deleted. LiveKit's playout accounting is worker-local — when it reports the goodbye complete,
+     * the caller's client still holds a few hundred milliseconds of buffered audio (network +
+     * jitter buffer), and deleting the room immediately clips the tail of the goodbye mid-air.
+     * Defaults to {@link DEFAULT_END_CALL_DRAIN_MS}; set `0` to hang up the instant playout ends.
+     */
+    drainMs?: number;
+    /**
+     * Safety cap in milliseconds on how long to wait for the agent's closing words to finish playing
+     * before hanging up, in case the speaking state never clears. Defaults to `30000`.
+     */
+    maxWaitMs?: number;
+}
+/**
+ * Grouped conversation & compliance configuration for {@link CreateLiveKitWorkerOptions.configuration}.
+ * A single home for related policy knobs so they don't each become a top-level worker option. Today
+ * it carries the greeting / AI-disclosure, consent requirements, agent-initiated hang-up, and
+ * per-call STT/TTS selection; it's the intended landing spot for further compliance controls
+ * (recording notice, data retention, …).
+ */
+export interface LiveKitWorkerConfiguration {
+    /** The opening greeting / AI-disclosure, plus optional periodic re-disclosure. See {@link GreetingConfiguration}. */
+    greeting?: GreetingConfiguration;
+    /**
+     * The call's consent policy. **Declarative only — the worker enforces nothing by itself.**
+     * Capture grants at runtime with `createConsentTool`; enforce them in your own code. See
+     * {@link ConsentConfiguration}.
+     */
+    consentPolicy?: ConsentConfiguration;
+    /** Let the agent end the call itself (say goodbye → hang up). See {@link EndCallConfiguration}. */
+    endCall?: EndCallConfiguration;
+    /**
+     * Per-call speech-to-text: a resolver invoked once per call (post-connect) with the call
+     * {@link VoiceCallContext}, returning anything the top-level `stt` option accepts (a plugin
+     * instance or an inference model string like `'deepgram/nova-3'`). Use it to pick the
+     * transcriber per tenant or language off the dispatch metadata / request context. Return
+     * `undefined` to fall back to the top-level `stt`. Runs during call setup, so keep it fast —
+     * when it constructs plugin instances, cache them across calls (e.g. a `Map` keyed by tenant).
+     */
+    stt?: SessionComponentResolver<voice.AgentSessionOptions['stt']>;
+    /**
+     * Per-call text-to-speech: a resolver invoked once per call (post-connect) with the call
+     * {@link VoiceCallContext}, returning anything the top-level `tts` option accepts (a plugin
+     * instance or an inference model string like `'cartesia/sonic-3'`). Use it to give each tenant
+     * its own voice / language. Return `undefined` to fall back to the top-level `tts`. Runs during
+     * call setup, so keep it fast — when it constructs plugin instances, cache them across calls.
+     */
+    tts?: SessionComponentResolver<voice.AgentSessionOptions['tts']>;
+}
+/**
+ * Resolves the effective greeting from the canonical `configuration.greeting` and the deprecated
+ * top-level `greeting` / `persistGreeting` options. The legacy options are the base so existing
+ * worker configs keep working unchanged; `configuration.greeting` overrides field-by-field. Exported
+ * for unit testing.
+ */
+export declare function resolveGreetingConfig(options: Pick<CreateLiveKitWorkerOptions, 'greeting' | 'persistGreeting' | 'configuration'>): GreetingConfiguration;
+/**
+ * Resolves the greeting text for a call: returns a fixed string as-is, or invokes the resolver form
+ * with the call context to produce a per-tenant greeting. Empty / whitespace-nothing results
+ * normalize to `undefined` (no greeting). Exported for unit testing.
+ */
+export declare function resolveGreetingText(text: GreetingText | undefined, context: GreetingContext): Promise<string | undefined>;
+/**
+ * Resolves a per-call session component (STT / TTS): invokes the `configuration` resolver with the
+ * call context, falling back to the static top-level option when there is no resolver or it
+ * resolves to `undefined`. Exported for unit testing.
+ */
+export declare function resolveSessionComponent<T>(resolver: SessionComponentResolver<T> | undefined, fallback: T | undefined, context: VoiceCallContext): Promise<T | undefined>;
+/** A {@link GreetingConfiguration} whose `text` resolver has been resolved to a plain string. */
+type ResolvedGreetingConfiguration = Omit<GreetingConfiguration, 'text'> & {
+    text?: string;
+};
+/**
+ * Speaks the session's opening greeting, honoring the interruption / playout options. Takes the
+ * already-resolved greeting (see {@link resolveGreetingText}) and returns the LiveKit `SpeechHandle`,
+ * or `undefined` when there is no greeting text. Extracted and exported so the greeting behavior is
+ * unit-testable without a live room.
+ */
+export declare function speakGreeting(session: Pick<voice.AgentSession, 'say'>, greeting: ResolvedGreetingConfiguration): Promise<ReturnType<voice.AgentSession['say']> | undefined>;
+/** Default tool name the worker watches for to end the call. Matches `createEndCallTool`'s default. */
+export declare const DEFAULT_END_CALL_TOOL = "endCall";
+/** Default shutdown reason recorded when the agent ends the call. */
+export declare const DEFAULT_END_CALL_REASON = "agent ended call";
+/** Default safety cap on waiting for the agent's closing words to finish before hanging up. */
+export declare const DEFAULT_END_CALL_MAX_WAIT_MS = 30000;
+/**
+ * Default post-playout drain before the room is deleted. LiveKit's "playout completed" is
+ * worker-local; the caller's client still holds network + jitter-buffer audio, so hanging up the
+ * instant the state clears clips the tail of the goodbye.
+ */
+export declare const DEFAULT_END_CALL_DRAIN_MS = 800;
+/** The minimal logger surface these helpers use (the Mastra logger satisfies it). */
+type WarnLogger = {
+    warn: (message: string, ...args: unknown[]) => void;
+};
+/**
+ * Resolves once the agent is no longer producing or playing a reply — i.e. its state has left
+ * `thinking`/`speaking` for `listening`/`idle`. Returns immediately when it's already idle. A
+ * `maxWaitMs` safety cap guarantees it resolves even if the speaking state never clears. Used before
+ * an agent-initiated hang-up so the closing words play out fully instead of being cut off by the
+ * session close. Exported for unit testing.
+ */
+export declare function waitForAgentDoneSpeaking(session: Pick<voice.AgentSession, 'agentState' | 'on' | 'off'>, maxWaitMs?: number): Promise<void>;
+/**
+ * Ends the call after the agent asked to (via its end-call tool): wait for the agent's closing words
+ * to finish, speak an optional final `message`, hold a short drain (`drainMs`) so audio buffered at
+ * the caller finishes playing, then disconnect. The teardown's session close
+ * force-interrupts any playing speech, so the waits here MUST complete before we disconnect — that's
+ * the whole point of the sequence. `ctx.deleteRoom()` hangs up the caller (SIP-safe); `ctx.shutdown()`
+ * ends the job and runs the registered shutdown callbacks (`onCallEnd`), so end-of-call work happens
+ * exactly as it does on a caller hang-up. Both run in a `finally` so a hiccup while waiting still ends
+ * the call. Never rejects — every step is guarded and failures are logged, so callers can safely
+ * fire-and-forget it (`void runEndCall(...)`) from hooks. Exported for unit testing.
+ */
+export declare function runEndCall(session: Pick<voice.AgentSession, 'agentState' | 'on' | 'off' | 'say'>, ctx: Pick<JobContext, 'deleteRoom' | 'shutdown'>, config: EndCallConfiguration, logger: WarnLogger): Promise<void>;
 /**
  * Builds a LiveKit agent worker definition that answers voice sessions with Mastra agents.
  *
@@ -182,6 +456,6 @@ export declare function buildTurnHandling(options: Pick<CreateLiveKitWorkerOptio
  * }
  * ```
  */
-export declare function createLiveKitWorker(options: CreateLiveKitWorkerOptions): import("@livekit/agents").Agent<WorkerUserData>;
+export declare function createLiveKitWorker(options: CreateLiveKitWorkerOptions): import("@livekit/agents").AgentDefinition<WorkerUserData>;
 export {};
 //# sourceMappingURL=worker.d.ts.map

package/dist/worker.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/livekit",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "LiveKit voice integration for Mastra agents — realtime voice with semantic turn detection and barge-in",
   "type": "module",
   "main": "./dist/index.js",
@@ -30,6 +30,16 @@
         "default": "./dist/worker-entry.cjs"
       }
     },
+    "./plugin": {
+      "import": {
+        "types": "./dist/plugin-entry.d.ts",
+        "default": "./dist/plugin-entry.js"
+      },
+      "require": {
+        "types": "./dist/plugin-entry.d.ts",
+        "default": "./dist/plugin-entry.cjs"
+      }
+    },
     "./package.json": "./package.json"
   },
   "keywords": [
@@ -77,15 +87,15 @@
     "@livekit/agents": "^1.4.5",
     "@livekit/agents-plugin-livekit": "^1.4.5",
     "@livekit/agents-plugin-silero": "^1.4.5",
-    "@types/node": "22.19.15",
+    "@types/node": "22.20.1",
     "eslint": "^10.4.1",
     "tsup": "^8.5.1",
     "typescript": "^6.0.3",
-    "vitest": "4.1.8",
+    "vitest": "4.1.10",
     "zod": "^4.4.3",
-    "@internal/lint": "0.0.112",
-    "@internal/types-builder": "0.0.87",
-    "@mastra/core": "1.50.0"
+    "@internal/types-builder": "0.0.89",
+    "@internal/lint": "0.0.114",
+    "@mastra/core": "1.51.0"
   },
   "scripts": {
     "build:lib": "tsup --silent --config tsup.config.ts",