kuralle-livekit

LiveKit voice/telephony integration for Kuralle, extracted from the main monorepo so it can evolve and version independently while Kuralle hardens text as the primary primitive.

These packages provide cascaded voice (STT → LLM → TTS) and the transports that carry audio between Kuralle voice sessions and browsers, servers, and telephony endpoints. They depend on @kuralle-agents/core (and @kuralle-agents/voice-protocol, @kuralle-agents/realtime-audio) as published npm packages — those remain in the main repo.

Packages

• @kuralle-agents/livekit-plugin — connects the Kuralle runtime + flow engine to LiveKit via a cascaded STT → LLM → TTS pipeline.
• @kuralle-agents/transport-base — shared transport abstraction.
• @kuralle-agents/livekit-plugin-transport-ws — WebSocket transport server + adapter (browser/server clients).
• @kuralle-agents/livekit-plugin-transport-http — HTTP/SSE transport.
• @kuralle-agents/livekit-plugin-transport-sip — SIP/RTP telephony (PBX trunks, SIP endpoints).
• @kuralle-agents/livekit-plugin-transport-twilio — Twilio Media Streams (inbound phone calls).
• @kuralle-agents/livekit-plugin-transport-smartpbx — SmartPBX WebSocket media-stream.

Apps (apps/)

• gemini-voice-agent — Gemini Live audio over a LiveKit WS transport (uses @kuralle-agents/realtime-audio + livekit-plugin-transport-ws).
• fly-sip-voice-agent — SIP telephony voice agent.
• livekit-starters/ — LiveKit agent starter template(s).
• transport-examples/ — HTTP / WS / SIP / Twilio / SmartPBX transport demos.

e2e/

LiveKit AgentSession bridge tests carried over from the main repo's e2e-tests. They reference the extracted packages and are not yet wired into a runner here — rewire against the workspace packages before using.

Develop

bun install
bun run build
bun run typecheck
bun run test

Extracted from kuralle/kuralle-agents on 2026-07-11. History was not carried over (fresh initial commit); see the main repo's git history for prior commits.