@plumbus/voice-livekit 0.1.2

package/dist/runtime/parse-participant-context.js

@@ -0,0 +1,61 @@
+function parseMetadataString(value) {
+    if (!value) {
+        return {};
+    }
+    try {
+        const parsed = JSON.parse(value);
+        if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+            return parsed;
+        }
+    }
+    catch {
+        // ignore malformed metadata
+    }
+    return {};
+}
+function readStringField(sources, key) {
+    for (const source of sources) {
+        const value = source[key];
+        if (typeof value === 'string' && value.length > 0) {
+            return value;
+        }
+    }
+    return undefined;
+}
+export function parseLiveKitParticipantContext(args) {
+    const metadata = parseMetadataString(args.participantMetadata);
+    const attributeRecord = args.participantAttributes ?? {};
+    const sources = [metadata, attributeRecord];
+    const sessionId = readStringField(sources, 'sessionId') ??
+        (args.roomName.length > 0 ? args.roomName : args.participantIdentity);
+    const userId = readStringField(sources, 'userId') ?? args.participantIdentity;
+    const tenantId = readStringField(sources, 'tenantId');
+    const projectId = readStringField(sources, 'projectId');
+    const language = readStringField(sources, 'language');
+    return {
+        userId,
+        tenantId,
+        projectId,
+        sessionId,
+        language,
+        metadata: {
+            ...metadata,
+            ...(tenantId ? { tenantId } : {}),
+            ...(projectId ? { projectId } : {}),
+            sessionId,
+            userId,
+            ...(language ? { language } : {}),
+        },
+    };
+}
+export function buildBrainInputFromParticipantContext(context) {
+    const brainInput = { sessionId: context.sessionId };
+    if (context.projectId) {
+        brainInput.projectId = context.projectId;
+    }
+    if (context.language) {
+        brainInput.language = context.language;
+    }
+    return brainInput;
+}
+//# sourceMappingURL=parse-participant-context.js.map

package/dist/runtime/parse-participant-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-participant-context.js","sourceRoot":"","sources":["../../src/runtime/parse-participant-context.ts"],"names":[],"mappings":"AASA,SAAS,mBAAmB,CAAC,KAAyB;IACpD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAY,CAAC;QAC5C,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACnE,OAAO,MAAiC,CAAC;QAC3C,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,4BAA4B;IAC9B,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,eAAe,CAAC,OAAkC,EAAE,GAAW;IACtE,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClD,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,IAK9C;IACC,MAAM,QAAQ,GAAG,mBAAmB,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAC/D,MAAM,eAAe,GAAG,IAAI,CAAC,qBAAqB,IAAI,EAAE,CAAC;IACzD,MAAM,OAAO,GAAG,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;IAE5C,MAAM,SAAS,GACb,eAAe,CAAC,OAAO,EAAE,WAAW,CAAC;QACrC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAExE,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,mBAAmB,CAAC;IAE9E,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,eAAe,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAEtD,OAAO;QACL,MAAM;QACN,QAAQ;QACR,SAAS;QACT,SAAS;QACT,QAAQ;QACR,QAAQ,EAAE;YACR,GAAG,QAAQ;YACX,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnC,SAAS;YACT,MAAM;YACN,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAClC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qCAAqC,CACnD,OAAkC;IAElC,MAAM,UAAU,GAA4B,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC;IAC7E,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,UAAU,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IAC3C,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,UAAU,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IACzC,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/runtime/voice-room-worker.d.ts

@@ -0,0 +1,55 @@
+import type { ExecutionContext } from '@plumbus/core';
+import { mergeRoomBrainInput, type VoiceProviderRegistry, VoiceSessionController } from '@plumbus/voice';
+import { type VoiceDefinition, type VoiceProvidersConfig, type VoiceSessionBudgetConfig } from '@plumbus/voice/provider-kit';
+import type { ConnectLiveKitWorkerArgs, LiveKitTransportProvider, LiveKitWorkerConnection } from '../types.js';
+export { mergeRoomBrainInput };
+export interface JoinVoiceRoomSessionOptions {
+    voice: VoiceDefinition;
+    providers: VoiceProvidersConfig;
+    roomName: string;
+    sessionId?: string;
+    createExecutionContext: (args: {
+        voiceName: string;
+        sessionId: string;
+        userId?: string;
+        tenantId?: string;
+        metadata?: Record<string, unknown>;
+    }) => ExecutionContext;
+    metadata?: Record<string, unknown>;
+    userId?: string;
+    tenantId?: string;
+    brainInput?: Record<string, unknown>;
+    signal?: AbortSignal;
+    registry?: VoiceProviderRegistry;
+    sessionBudget?: VoiceSessionBudgetConfig;
+    connectLiveKitWorker?: (transport: LiveKitTransportProvider, args: ConnectLiveKitWorkerArgs) => Promise<LiveKitWorkerConnection>;
+}
+export interface VoiceRoomSessionHandle {
+    sessionId: string;
+    controller: VoiceSessionController;
+    stop(): Promise<void>;
+}
+export declare function joinVoiceRoomSession(options: JoinVoiceRoomSessionOptions): Promise<VoiceRoomSessionHandle>;
+export interface StartVoiceWorkerOptions {
+    voices: VoiceDefinition[];
+    providers: VoiceProvidersConfig;
+    createExecutionContext: JoinVoiceRoomSessionOptions['createExecutionContext'];
+    roomName?: string;
+    sessionId?: string;
+    voiceName?: string;
+    metadata?: Record<string, unknown>;
+    userId?: string;
+    tenantId?: string;
+    brainInput?: Record<string, unknown>;
+    signal?: AbortSignal;
+    registry?: VoiceProviderRegistry;
+    sessionBudget?: VoiceSessionBudgetConfig;
+    connectLiveKitWorker?: (transport: LiveKitTransportProvider, args: ConnectLiveKitWorkerArgs) => Promise<LiveKitWorkerConnection>;
+}
+export interface VoiceWorkerHandle {
+    sessionId: string;
+    stop(): Promise<void>;
+}
+/** @deprecated Prefer joinVoiceRoomSession or startVoiceAgentWorker for per-room dispatch. */
+export declare function startVoiceWorker(options: StartVoiceWorkerOptions): Promise<VoiceWorkerHandle>;
+//# sourceMappingURL=voice-room-worker.d.ts.map

package/dist/runtime/voice-room-worker.d.ts.map

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

package/dist/runtime/voice-room-worker.js

@@ -0,0 +1,151 @@
+import { randomUUID } from 'node:crypto';
+import { ErrorCode, PlumbusError } from '@plumbus/core';
+import { createSTTProvider, createTransportProvider, createTTSProvider, mergeRoomBrainInput, VoiceSessionController, validateVoiceProviders, } from '@plumbus/voice';
+import { createVoiceSessionBudget, } from '@plumbus/voice/provider-kit';
+import { DEFAULT_AGENT_AUDIO_TRACK_NAME } from '../client/session-helpers.js';
+import { recordLiveKitTransportCost } from '../cost/record-livekit-transport.js';
+export { mergeRoomBrainInput };
+function assertLiveKitTransport(registry) {
+    if (registry.transport.has('livekit')) {
+        return registry;
+    }
+    throw new PlumbusError(ErrorCode.DependencyViolation, 'LiveKit room session registry must include transport.livekit (LIVEKIT_TRANSPORT_REGISTRATION)', { installPackage: '@plumbus/voice-livekit' });
+}
+function resolveRoomRegistry(existing) {
+    if (!existing) {
+        throw new PlumbusError(ErrorCode.DependencyViolation, 'LiveKit room session requires an explicit registry (pass LIVEKIT_TRANSPORT_REGISTRATION and STT/TTS registrations via createProviderRegistry, or export voiceProviderRegistry from app/voice/registry.ts)');
+    }
+    return assertLiveKitTransport(existing);
+}
+export async function joinVoiceRoomSession(options) {
+    const registry = resolveRoomRegistry(options.registry);
+    const validation = validateVoiceProviders({
+        voices: [options.voice],
+        providers: options.providers,
+        registry,
+    });
+    if (!validation.ok) {
+        const detail = validation.issues.map((issue) => issue.message).join('; ');
+        throw new PlumbusError(ErrorCode.Validation, `Voice room session cannot start with invalid providers: ${detail}`);
+    }
+    const sessionId = options.sessionId ?? options.roomName;
+    const connectedAt = new Date();
+    const metadata = options.metadata ?? {};
+    const userId = options.userId ??
+        (typeof metadata.userId === 'string' ? metadata.userId : undefined) ??
+        'voice-worker';
+    const ctx = options.createExecutionContext({
+        voiceName: options.voice.name,
+        sessionId,
+        userId,
+        tenantId: options.tenantId ?? (typeof metadata.tenantId === 'string' ? metadata.tenantId : undefined),
+        metadata,
+    });
+    const transport = createTransportProvider({
+        registry,
+        providers: options.providers,
+        voiceSlice: options.voice.transport,
+    });
+    const sttProvider = createSTTProvider({
+        registry,
+        providers: options.providers,
+        voiceSlice: options.voice.stt,
+    });
+    const ttsProvider = createTTSProvider({
+        registry,
+        providers: options.providers,
+        voiceSlice: options.voice.tts,
+    });
+    const budget = createVoiceSessionBudget(options.sessionBudget);
+    const controller = new VoiceSessionController({
+        voice: options.voice,
+        sessionId,
+        userId,
+        ctx,
+        sttProvider,
+        ttsProvider,
+        transportProvider: transport,
+        budget,
+        brainInput: mergeRoomBrainInput(options.brainInput, metadata),
+        onEvent: async (event) => {
+            await transport.sendData(event);
+        },
+        onAudioChunk: async (chunk) => {
+            await transport.publishAudio(chunk);
+        },
+    });
+    const workerArgs = {
+        voiceName: options.voice.name,
+        room: options.roomName,
+        identity: `voice-agent:${options.voice.name}`,
+        metadata: JSON.stringify(metadata),
+        agentAudioTrackName: resolveAgentTrackName(options.voice),
+        signal: options.signal,
+        onAudio: async (audio) => {
+            await controller.handleAudioChunk(audio, options.voice.transport.audioFormat);
+        },
+        onData: async (payload) => {
+            if (!payload || typeof payload !== 'object')
+                return;
+            await controller.handleControlMessage(payload);
+        },
+    };
+    const connection = options.connectLiveKitWorker
+        ? await options.connectLiveKitWorker(transport, workerArgs)
+        : await transport.connectWorker(workerArgs);
+    await controller.hello();
+    return {
+        sessionId,
+        controller,
+        async stop() {
+            const disconnectedAt = new Date();
+            await recordLiveKitTransportCost(ctx, {
+                sessionId,
+                connectedAt,
+                disconnectedAt,
+            });
+            await controller.dispose();
+            await connection.disconnect();
+        },
+    };
+}
+function resolveAgentTrackName(voice) {
+    const configured = voice.transport.options?.agentAudioTrackName;
+    return typeof configured === 'string' && configured.length > 0
+        ? configured
+        : DEFAULT_AGENT_AUDIO_TRACK_NAME;
+}
+/** @deprecated Prefer joinVoiceRoomSession or startVoiceAgentWorker for per-room dispatch. */
+export async function startVoiceWorker(options) {
+    const livekitVoices = options.voices.filter((voice) => voice.transport.provider === 'livekit');
+    if (livekitVoices.length === 0) {
+        throw new PlumbusError(ErrorCode.Validation, 'startVoiceWorker requires at least one livekit voice');
+    }
+    const selected = (options.voiceName
+        ? livekitVoices.find((candidate) => candidate.name === options.voiceName)
+        : undefined) ?? livekitVoices[0];
+    if (!selected) {
+        throw new PlumbusError(ErrorCode.Validation, 'startVoiceWorker could not resolve a voice');
+    }
+    const roomName = options.roomName ?? `voice-${randomUUID()}`;
+    const handle = await joinVoiceRoomSession({
+        voice: selected,
+        providers: options.providers,
+        roomName,
+        sessionId: options.sessionId ?? roomName,
+        createExecutionContext: options.createExecutionContext,
+        metadata: options.metadata,
+        userId: options.userId,
+        tenantId: options.tenantId,
+        brainInput: options.brainInput,
+        signal: options.signal,
+        registry: options.registry,
+        sessionBudget: options.sessionBudget,
+        connectLiveKitWorker: options.connectLiveKitWorker,
+    });
+    return {
+        sessionId: handle.sessionId,
+        stop: () => handle.stop(),
+    };
+}
+//# sourceMappingURL=voice-room-worker.js.map

package/dist/runtime/voice-room-worker.js.map

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

package/dist/transport/livekit-transport.d.ts

@@ -0,0 +1,37 @@
+import { type TransportProviderRegistration, type TransportProviderSession, type VoiceProviderCredentials, type VoiceTransportConfig } from '@plumbus/voice/provider-kit';
+import { LIVEKIT_TRANSPORT_DESCRIPTOR } from '../descriptor.js';
+import type { ConnectLiveKitWorkerArgs, LiveKitTransportProvider as LiveKitTransportProviderContract, LiveKitWorkerConnection, MintLiveKitParticipantTokenArgs } from '../types.js';
+export type { ConnectLiveKitWorkerArgs, LiveKitSessionMetadata, LiveKitWorkerConnection, MintLiveKitParticipantTokenArgs, } from '../types.js';
+export { LIVEKIT_TRANSPORT_DESCRIPTOR };
+export interface MintLiveKitSessionArgs {
+    voiceName: string;
+    userId?: string;
+    sessionId?: string;
+    roomName?: string;
+    metadata?: Record<string, unknown>;
+    attributes?: Record<string, string>;
+    tokenTtlSeconds?: number;
+    identity?: string;
+}
+export type LiveKitRoomResolver = (args: {
+    voiceName: string;
+    userId?: string;
+    sessionId: string;
+}) => string;
+export declare function mintLiveKitParticipantToken(args: MintLiveKitParticipantTokenArgs): Promise<string>;
+export declare class LiveKitTransportProvider implements LiveKitTransportProviderContract {
+    private readonly credentials;
+    private readonly voiceSlice;
+    private activeConnection?;
+    constructor(credentials: VoiceProviderCredentials, voiceSlice: VoiceTransportConfig);
+    mintSession(args: MintLiveKitSessionArgs): Promise<TransportProviderSession>;
+    connectWorker(args: ConnectLiveKitWorkerArgs): Promise<LiveKitWorkerConnection>;
+    publishAudio(audio: Uint8Array): Promise<void>;
+    subscribeRemote(onAudio: (audio: Uint8Array) => Promise<void> | void): void;
+    sendData(payload: unknown): Promise<void>;
+    disconnect(): Promise<void>;
+    private createSessionMetadata;
+    private forwardRemoteAudio;
+}
+export declare const LIVEKIT_TRANSPORT_REGISTRATION: TransportProviderRegistration;
+//# sourceMappingURL=livekit-transport.d.ts.map

package/dist/transport/livekit-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"livekit-transport.d.ts","sourceRoot":"","sources":["../../src/transport/livekit-transport.ts"],"names":[],"mappings":"AAYA,OAAO,EAEL,KAAK,6BAA6B,EAClC,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EAC1B,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AAIhE,OAAO,KAAK,EACV,wBAAwB,EAExB,wBAAwB,IAAI,gCAAgC,EAC5D,uBAAuB,EACvB,+BAA+B,EAChC,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,+BAA+B,GAChC,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,4BAA4B,EAAE,CAAC;AASxC,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,mBAAmB,GAAG,CAAC,IAAI,EAAE;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB,KAAK,MAAM,CAAC;AAEb,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,+BAA+B,GACpC,OAAO,CAAC,MAAM,CAAC,CA0BjB;AAED,qBAAa,wBAAyB,YAAW,gCAAgC;IAU7E,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAV7B,OAAO,CAAC,gBAAgB,CAAC,CAMvB;gBAGiB,WAAW,EAAE,wBAAwB,EACrC,UAAU,EAAE,oBAAoB;IAG7C,WAAW,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAqB5E,aAAa,CAAC,IAAI,EAAE,wBAAwB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAmE/E,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAcpD,eAAe,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI;IAMrE,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAWzC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YAUnB,qBAAqB;YAuDrB,kBAAkB;CAWjC;AAED,eAAO,MAAM,8BAA8B,EAAE,6BAuB5C,CAAC"}

package/dist/transport/livekit-transport.js

@@ -0,0 +1,324 @@
+import { randomUUID } from 'node:crypto';
+import { AudioFrame, AudioSource, LocalAudioTrack, Room, RoomEvent, TrackKind, TrackPublishOptions, } from '@livekit/rtc-node';
+import { ErrorCode, PlumbusError } from '@plumbus/core';
+import { readNoiseCancellationFromTransportOptions, } from '@plumbus/voice/provider-kit';
+import { AccessToken, RoomAgentDispatch, RoomConfiguration } from 'livekit-server-sdk';
+import { LIVEKIT_TRANSPORT_DESCRIPTOR } from '../descriptor.js';
+import { createInboundAudioStream } from '../noise-cancellation/create-inbound-audio-stream.js';
+import { LIVEKIT_VOICE_PRICING } from '../pricing.js';
+import { consumeAudioStream } from '../runtime/consume-audio-stream.js';
+export { LIVEKIT_TRANSPORT_DESCRIPTOR };
+const DEFAULT_AUDIO_FORMAT = 'pcm16;rate=16000;channels=1';
+const DEFAULT_DATA_TOPIC = 'voice.events';
+const DEFAULT_SESSION_TTL_SECONDS = 3600;
+const MAX_SESSION_TTL_SECONDS = 7200;
+const DEFAULT_AGENT_AUDIO_TRACK_NAME = 'agent-voice';
+const DEFAULT_ROOM_USER = 'voiceUser';
+export async function mintLiveKitParticipantToken(args) {
+    const accessToken = new AccessToken(args.apiKey, args.apiSecret, {
+        identity: args.identity,
+        name: args.participantName ?? args.identity,
+        ttl: clampTokenTtlSeconds(args.ttlSeconds ?? DEFAULT_SESSION_TTL_SECONDS),
+        metadata: args.metadata,
+        attributes: sanitizeAttributes(args.attributes),
+    });
+    accessToken.addGrant({
+        room: args.room,
+        roomJoin: true,
+        canPublish: true,
+        canSubscribe: true,
+        canPublishData: true,
+    });
+    if (args.agentName) {
+        accessToken.roomConfig = new RoomConfiguration({
+            agents: [
+                new RoomAgentDispatch({
+                    agentName: args.agentName,
+                    metadata: args.agentMetadata ?? args.metadata ?? '',
+                }),
+            ],
+        });
+    }
+    return accessToken.toJwt();
+}
+export class LiveKitTransportProvider {
+    credentials;
+    voiceSlice;
+    activeConnection;
+    constructor(credentials, voiceSlice) {
+        this.credentials = credentials;
+        this.voiceSlice = voiceSlice;
+    }
+    async mintSession(args) {
+        const sessionId = args.sessionId ?? `livekit:${args.voiceName}:${args.userId ?? 'anonymous'}:${randomUUID()}`;
+        const serializedMetadata = serializeMetadata(args.metadata);
+        const metadata = await this.createSessionMetadata(args.voiceName, args.userId, {
+            room: args.roomName,
+            identity: args.identity,
+            ttlSeconds: args.tokenTtlSeconds,
+            metadata: serializedMetadata,
+            attributes: args.attributes,
+            sessionId,
+            agentName: args.voiceName,
+            agentMetadata: serializedMetadata,
+        });
+        return {
+            sessionId,
+            transport: 'livekit',
+            metadata: metadata,
+        };
+    }
+    async connectWorker(args) {
+        if (args.signal?.aborted) {
+            throw new PlumbusError(ErrorCode.Cancelled, 'LiveKit worker connection aborted before connect');
+        }
+        const metadata = await this.createSessionMetadata(args.voiceName, args.identity, {
+            room: args.room,
+            identity: args.identity,
+            audioTrackName: args.agentAudioTrackName ?? args.audioTrackName,
+            ttlSeconds: resolveWorkerTokenTtlSeconds(this.voiceSlice.options),
+            token: args.token,
+            participantName: args.participantName,
+            metadata: args.metadata,
+            attributes: args.attributes,
+        });
+        const room = new Room();
+        await room.connect(metadata.url, metadata.token);
+        const audioSource = createAudioSource(metadata.audioFormat);
+        const localTrack = LocalAudioTrack.createAudioTrack(metadata.audioTrackName, audioSource);
+        const publishOptions = new TrackPublishOptions();
+        await room.localParticipant?.publishTrack(localTrack, publishOptions);
+        const activeConnection = {
+            room,
+            audioSource,
+            localTrack,
+            dataTopic: args.dataTopic ?? DEFAULT_DATA_TOPIC,
+            onAudio: args.onAudio,
+        };
+        this.activeConnection = activeConnection;
+        if (args.signal) {
+            args.signal.addEventListener('abort', () => {
+                void this.disconnect();
+            }, { once: true });
+        }
+        room.on(RoomEvent.TrackSubscribed, (track) => {
+            if (!this.activeConnection)
+                return;
+            const isAudio = track.kind === TrackKind.KIND_AUDIO || track.kind === 1;
+            if (!isAudio || !this.activeConnection.onAudio)
+                return;
+            void this.forwardRemoteAudio(track, this.activeConnection.onAudio);
+        });
+        room.on(RoomEvent.DataReceived, (payload) => {
+            if (!args.onData)
+                return;
+            void args.onData(parseLiveKitDataPayload(payload));
+        });
+        return {
+            room,
+            disconnect: async () => {
+                await this.disconnect();
+            },
+        };
+    }
+    async publishAudio(audio) {
+        const connection = this.activeConnection;
+        if (!connection)
+            return;
+        const format = parsePcmFormat(this.voiceSlice.audioFormat);
+        const audioFrame = new AudioFrame(pcmBytesToInt16(audio), format.sampleRate, format.channels, Math.max(1, audio.byteLength / (2 * format.channels)));
+        await connection.audioSource.captureFrame(audioFrame);
+    }
+    subscribeRemote(onAudio) {
+        if (this.activeConnection) {
+            this.activeConnection.onAudio = onAudio;
+        }
+    }
+    async sendData(payload) {
+        const connection = this.activeConnection;
+        if (!connection?.room.localParticipant)
+            return;
+        const encoded = new TextEncoder().encode(JSON.stringify(payload));
+        await connection.room.localParticipant.publishData(encoded, {
+            reliable: true,
+            topic: connection.dataTopic,
+        });
+    }
+    async disconnect() {
+        const connection = this.activeConnection;
+        this.activeConnection = undefined;
+        if (!connection)
+            return;
+        await connection.localTrack.close();
+        await connection.audioSource.close();
+        await connection.room.disconnect();
+    }
+    async createSessionMetadata(voiceName, userId, overrides = {}) {
+        const url = requireString(this.credentials.url, 'LiveKit url');
+        const apiKey = requireString(this.credentials.apiKey, 'LiveKit apiKey');
+        const apiSecret = requireString(this.credentials.apiSecret, 'LiveKit apiSecret');
+        const sessionId = overrides.sessionId ?? `livekit:${voiceName}:${userId ?? 'anonymous'}:${randomUUID()}`;
+        const room = overrides.room ?? resolveRoomName(this.voiceSlice, voiceName, userId, sessionId);
+        const identity = overrides.identity ?? resolveIdentity(voiceName, userId);
+        const audioFormat = normalizeAudioFormat(this.voiceSlice.audioFormat);
+        const audioTrackName = overrides.audioTrackName ?? resolveAgentAudioTrackName(this.voiceSlice, voiceName, identity);
+        let token = overrides.token;
+        if (!token) {
+            token = await mintLiveKitParticipantToken({
+                apiKey,
+                apiSecret,
+                room,
+                identity,
+                participantName: overrides.participantName ?? identity,
+                ttlSeconds: overrides.ttlSeconds ?? resolveLiveKitTokenTtlSeconds(this.voiceSlice.options),
+                metadata: overrides.metadata,
+                attributes: sanitizeAttributes(overrides.attributes),
+                agentName: overrides.agentName,
+                agentMetadata: overrides.agentMetadata ?? overrides.metadata,
+            });
+        }
+        return {
+            url,
+            room,
+            token,
+            identity,
+            audioFormat,
+            audioTrackName,
+            mode: this.voiceSlice.mode ?? 'pushToTalk',
+        };
+    }
+    async forwardRemoteAudio(track, onAudio) {
+        const format = parsePcmFormat(this.voiceSlice.audioFormat);
+        const noiseCancellation = readNoiseCancellationFromTransportOptions(this.voiceSlice.options);
+        const stream = createInboundAudioStream(track, format, noiseCancellation);
+        await consumeAudioStream(stream, async (frame) => {
+            await onAudio(int16ToBytes(frame.data));
+        });
+    }
+}
+export const LIVEKIT_TRANSPORT_REGISTRATION = {
+    descriptor: LIVEKIT_TRANSPORT_DESCRIPTOR,
+    pricing: LIVEKIT_VOICE_PRICING,
+    create(credentials, voiceSlice) {
+        return new LiveKitTransportProvider(credentials, voiceSlice);
+    },
+    toClientSessionPayload(session) {
+        const metadata = session.metadata ?? {};
+        const audioTrackName = typeof metadata.audioTrackName === 'string' ? metadata.audioTrackName : undefined;
+        return {
+            transport: 'livekit',
+            url: metadata.url,
+            token: metadata.token,
+            room: metadata.room,
+            identity: metadata.identity,
+            audioTrackName,
+            agentAudioTrackName: audioTrackName,
+            audioFormat: metadata.audioFormat,
+            mode: metadata.mode,
+            sessionId: session.sessionId,
+        };
+    },
+};
+function createAudioSource(audioFormat) {
+    const format = parsePcmFormat(audioFormat);
+    return new AudioSource(format.sampleRate, format.channels);
+}
+function parsePcmFormat(audioFormat) {
+    const normalized = normalizeAudioFormat(audioFormat);
+    const rateMatch = normalized.match(/rate=(\d+)/);
+    const channelsMatch = normalized.match(/channels=(\d+)/);
+    const frameSizeMatch = normalized.match(/frame=(\d+)/);
+    return {
+        sampleRate: Number(rateMatch?.[1] ?? 16000),
+        channels: Number(channelsMatch?.[1] ?? 1),
+        frameSizeMs: Number(frameSizeMatch?.[1] ?? 20),
+    };
+}
+function normalizeAudioFormat(audioFormat) {
+    if (!audioFormat)
+        return DEFAULT_AUDIO_FORMAT;
+    if (audioFormat.includes('rate='))
+        return audioFormat;
+    const short = audioFormat.toLowerCase();
+    if (short === 'pcm16-16k') {
+        return DEFAULT_AUDIO_FORMAT;
+    }
+    if (short === 'pcm16-24k') {
+        return 'pcm16;rate=24000;channels=1';
+    }
+    return audioFormat;
+}
+function resolveRoomName(voiceSlice, voiceName, userId, sessionId) {
+    const resolver = voiceSlice.options?.roomResolver;
+    if (typeof resolver === 'function') {
+        return resolver({
+            voiceName,
+            userId: userId ?? DEFAULT_ROOM_USER,
+            sessionId,
+        });
+    }
+    const configuredRoom = voiceSlice.options?.room;
+    if (typeof configuredRoom === 'string' && configuredRoom.length > 0) {
+        return configuredRoom;
+    }
+    return `${voiceName}-${userId ?? DEFAULT_ROOM_USER}`;
+}
+function resolveIdentity(voiceName, userId) {
+    return `${voiceName}:${userId ?? `anonymous:${randomUUID()}`}`;
+}
+function resolveAgentAudioTrackName(voiceSlice, _voiceName, _identity) {
+    const configured = voiceSlice.options?.agentAudioTrackName;
+    if (typeof configured === 'string' && configured.length > 0) {
+        return configured;
+    }
+    return DEFAULT_AGENT_AUDIO_TRACK_NAME;
+}
+function resolveLiveKitTokenTtlSeconds(options) {
+    const value = options?.tokenTtlSeconds;
+    return typeof value === 'number' && value > 0
+        ? clampTokenTtlSeconds(value)
+        : DEFAULT_SESSION_TTL_SECONDS;
+}
+function resolveWorkerTokenTtlSeconds(options) {
+    const value = options?.workerTokenTtlSeconds;
+    return typeof value === 'number' && value > 0
+        ? clampTokenTtlSeconds(value)
+        : DEFAULT_SESSION_TTL_SECONDS;
+}
+function clampTokenTtlSeconds(value) {
+    return Math.min(Math.max(1, value), MAX_SESSION_TTL_SECONDS);
+}
+function requireString(value, label) {
+    if (!value) {
+        throw new PlumbusError(ErrorCode.Validation, `${label} is required`);
+    }
+    return value;
+}
+function sanitizeAttributes(attributes) {
+    if (!attributes)
+        return undefined;
+    return Object.fromEntries(Object.entries(attributes).filter((entry) => typeof entry[0] === 'string' && typeof entry[1] === 'string'));
+}
+function serializeMetadata(metadata) {
+    if (!metadata)
+        return undefined;
+    return JSON.stringify(metadata);
+}
+function pcmBytesToInt16(audio) {
+    const buffer = audio.byteOffset === 0 && audio.byteLength === audio.buffer.byteLength
+        ? audio.buffer
+        : audio.buffer.slice(audio.byteOffset, audio.byteOffset + audio.byteLength);
+    return new Int16Array(buffer);
+}
+function int16ToBytes(frame) {
+    return new Uint8Array(frame.buffer.slice(frame.byteOffset, frame.byteOffset + frame.byteLength));
+}
+function parseLiveKitDataPayload(payload) {
+    try {
+        return JSON.parse(Buffer.from(payload).toString('utf-8'));
+    }
+    catch {
+        return { type: 'error', code: 'voice.invalid_message', message: 'Expected JSON control frame' };
+    }
+}
+//# sourceMappingURL=livekit-transport.js.map