roomkit 0.2.0__tar.gz → 0.2.1__tar.gz

{roomkit-0.2.0 → roomkit-0.2.1}/AGENTS.md

@@ -44,6 +44,7 @@ src/roomkit/
 │   ├── base.py          # Channel ABC
 │   ├── transport.py     # TransportChannel (SMS, Email, etc.)
 │   ├── ai.py            # AIChannel (intelligence layer)
+│   ├── voice.py         # VoiceChannel (real-time audio)
 │   └── websocket.py     # WebSocketChannel
 ├── providers/
 │   ├── ai/base.py       # AIProvider ABC, AIContext, AIResponse
@@ -66,6 +67,22 @@ src/roomkit/
 ├── realtime/
 │   ├── base.py          # RealtimeBackend ABC, EphemeralEvent
 │   └── memory.py        # InMemoryRealtime
+├── voice/
+│   ├── __init__.py      # Voice subsystem exports
+│   ├── base.py          # Shared types (AudioChunk, VoiceSession, callbacks)
+│   ├── events.py        # Voice-specific events
+│   ├── stt/             # Speech-to-text providers
+│   │   ├── base.py      # STTProvider ABC
+│   │   ├── mock.py      # MockSTTProvider
+│   │   └── deepgram.py  # DeepgramSTTProvider
+│   ├── tts/             # Text-to-speech providers
+│   │   ├── base.py      # TTSProvider ABC
+│   │   ├── mock.py      # MockTTSProvider
+│   │   └── elevenlabs.py # ElevenLabsTTSProvider
+│   └── backends/        # Voice transport backends
+│       ├── base.py      # VoiceBackend ABC
+│       ├── mock.py      # MockVoiceBackend, MockVoiceCall
+│       └── fastrtc.py   # FastRTCVoiceBackend (WebRTC)
 └── identity/
     ├── base.py          # IdentityResolver ABC
     └── mock.py          # MockIdentityResolver

{roomkit-0.2.0 → roomkit-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: roomkit
-Version: 0.2.0
+Version: 0.2.1
 Summary: Pure async Python library for multi-channel conversations
 Project-URL: Homepage, https://roomkit.live
 Project-URL: Repository, https://github.com/sboily/roomkit
@@ -92,14 +92,14 @@ Description-Content-Type: text/markdown
 
 Pure async Python 3.12+ library for multi-channel conversations.
 
-RoomKit gives you a single abstraction — the **room** — to orchestrate messages across SMS, RCS, Email, WhatsApp, Messenger, WebSocket, HTTP webhooks, and AI channels. Events flow in through any channel, get validated by hooks, and broadcast to every other channel in the room with automatic content transcoding.
+RoomKit gives you a single abstraction — the **room** — to orchestrate messages across SMS, RCS, Email, WhatsApp, Messenger, Voice, WebSocket, HTTP webhooks, and AI channels. Events flow in through any channel, get validated by hooks, and broadcast to every other channel in the room with automatic content transcoding.
 
 ```
 Inbound ──► Hook pipeline ──► Store ──► Broadcast to all channels
                                              │
-              ┌──────────┬──────────┬────────┼────────┬────────┐
-              ▼          ▼          ▼        ▼        ▼        ▼
-           SMS/RCS   WebSocket   Email   Messenger   AI    Webhook
+              ┌──────────┬──────────┬────────┼────────┬────────┬────────┐
+              ▼          ▼          ▼        ▼        ▼        ▼        ▼
+           SMS/RCS   WebSocket   Email   Messenger  Voice     AI    Webhook
 ```
 
 **Website:** [www.roomkit.live](https://www.roomkit.live) | **Docs:** [www.roomkit.live/docs](https://www.roomkit.live/docs/)
@@ -166,6 +166,7 @@ pip install roomkit[websocket]         # WebSocket event source
 pip install roomkit[anthropic]         # Anthropic Claude AI
 pip install roomkit[openai]            # OpenAI GPT
 pip install roomkit[gemini]            # Google Gemini AI
+pip install roomkit[fastrtc]           # FastRTC voice backend
 pip install roomkit[providers]         # all transport providers
 pip install roomkit[all]               # everything
 ```
@@ -193,10 +194,11 @@ Each channel is a thin adapter between the room and an external transport. All c
 | **WebSocket** | `websocket` | text, rich, media | Real-time with typing, reactions |
 | **Messenger** | `messenger` | text, rich, media, template | Buttons, quick replies |
 | **WhatsApp** | `whatsapp` | text, rich, media, location, template | Buttons, templates |
+| **Voice** | `voice` | audio, text | STT/TTS, barge-in, FastRTC streaming |
 | **HTTP** | `webhook` | text, rich | Generic webhook for any system |
 | **AI** | `ai` | text, rich | Intelligence layer (not transport) |
 
-Channels have two categories: **transport** (delivers to external systems) and **intelligence** (generates content, like AI).
+Channels have two categories: **transport** (delivers to external systems) and **intelligence** (generates content, like AI). The Voice channel bridges real-time audio with the room-based conversation model.
 
 ## Providers
 
@@ -226,6 +228,14 @@ Providers handle the actual API calls. Every provider has a mock counterpart for
 | `OpenAIAIProvider` | GPT-4, vision, tools | `roomkit[openai]` |
 | `GeminiAIProvider` | Gemini, vision, tools | `roomkit[gemini]` |
 
+### Voice Providers
+
+| Provider | Role | Dependency |
+|----------|------|------------|
+| `DeepgramSTTProvider` | Speech-to-text | `roomkit[httpx]` |
+| `ElevenLabsTTSProvider` | Text-to-speech | `roomkit[httpx]` |
+| `FastRTCVoiceBackend` | WebRTC audio transport | `roomkit[fastrtc]` |
+
 ### Other Providers
 
 | Provider | Channel | Dependency |
@@ -551,6 +561,7 @@ src/roomkit/
   realtime/        Ephemeral events (typing, presence, read receipts)
   sources/         Event-driven sources (WebSocket, custom)
   store/           Storage abstraction and in-memory implementation
+  voice/           Voice subsystem (stt/, tts/, backends/)
 ```
 
 ## Documentation

{roomkit-0.2.0 → roomkit-0.2.1}/README.md

@@ -6,14 +6,14 @@
 
 Pure async Python 3.12+ library for multi-channel conversations.
 
-RoomKit gives you a single abstraction — the **room** — to orchestrate messages across SMS, RCS, Email, WhatsApp, Messenger, WebSocket, HTTP webhooks, and AI channels. Events flow in through any channel, get validated by hooks, and broadcast to every other channel in the room with automatic content transcoding.
+RoomKit gives you a single abstraction — the **room** — to orchestrate messages across SMS, RCS, Email, WhatsApp, Messenger, Voice, WebSocket, HTTP webhooks, and AI channels. Events flow in through any channel, get validated by hooks, and broadcast to every other channel in the room with automatic content transcoding.
 
 ```
 Inbound ──► Hook pipeline ──► Store ──► Broadcast to all channels
                                              │
-              ┌──────────┬──────────┬────────┼────────┬────────┐
-              ▼          ▼          ▼        ▼        ▼        ▼
-           SMS/RCS   WebSocket   Email   Messenger   AI    Webhook
+              ┌──────────┬──────────┬────────┼────────┬────────┬────────┐
+              ▼          ▼          ▼        ▼        ▼        ▼        ▼
+           SMS/RCS   WebSocket   Email   Messenger  Voice     AI    Webhook
 ```
 
 **Website:** [www.roomkit.live](https://www.roomkit.live) | **Docs:** [www.roomkit.live/docs](https://www.roomkit.live/docs/)
@@ -80,6 +80,7 @@ pip install roomkit[websocket]         # WebSocket event source
 pip install roomkit[anthropic]         # Anthropic Claude AI
 pip install roomkit[openai]            # OpenAI GPT
 pip install roomkit[gemini]            # Google Gemini AI
+pip install roomkit[fastrtc]           # FastRTC voice backend
 pip install roomkit[providers]         # all transport providers
 pip install roomkit[all]               # everything
 ```
@@ -107,10 +108,11 @@ Each channel is a thin adapter between the room and an external transport. All c
 | **WebSocket** | `websocket` | text, rich, media | Real-time with typing, reactions |
 | **Messenger** | `messenger` | text, rich, media, template | Buttons, quick replies |
 | **WhatsApp** | `whatsapp` | text, rich, media, location, template | Buttons, templates |
+| **Voice** | `voice` | audio, text | STT/TTS, barge-in, FastRTC streaming |
 | **HTTP** | `webhook` | text, rich | Generic webhook for any system |
 | **AI** | `ai` | text, rich | Intelligence layer (not transport) |
 
-Channels have two categories: **transport** (delivers to external systems) and **intelligence** (generates content, like AI).
+Channels have two categories: **transport** (delivers to external systems) and **intelligence** (generates content, like AI). The Voice channel bridges real-time audio with the room-based conversation model.
 
 ## Providers
 
@@ -140,6 +142,14 @@ Providers handle the actual API calls. Every provider has a mock counterpart for
 | `OpenAIAIProvider` | GPT-4, vision, tools | `roomkit[openai]` |
 | `GeminiAIProvider` | Gemini, vision, tools | `roomkit[gemini]` |
 
+### Voice Providers
+
+| Provider | Role | Dependency |
+|----------|------|------------|
+| `DeepgramSTTProvider` | Speech-to-text | `roomkit[httpx]` |
+| `ElevenLabsTTSProvider` | Text-to-speech | `roomkit[httpx]` |
+| `FastRTCVoiceBackend` | WebRTC audio transport | `roomkit[fastrtc]` |
+
 ### Other Providers
 
 | Provider | Channel | Dependency |
@@ -465,6 +475,7 @@ src/roomkit/
   realtime/        Ephemeral events (typing, presence, read receipts)
   sources/         Event-driven sources (WebSocket, custom)
   store/           Storage abstraction and in-memory implementation
+  voice/           Voice subsystem (stt/, tts/, backends/)
 ```
 
 ## Documentation

{roomkit-0.2.0 → roomkit-0.2.1}/docs/llms.txt

@@ -1,7 +1,7 @@
 # RoomKit
 
 > RoomKit is a pure async Python library for building multi-channel conversation systems.
-> It provides room-based abstractions for managing conversations across SMS, Email, WebSocket,
+> It provides room-based abstractions for managing conversations across SMS, Email, Voice, WebSocket,
 > AI, and other channels with pluggable storage, identity resolution, hooks, and realtime events.
 > Python 3.12+, Pydantic 2.x, fully typed, zero required dependencies beyond Pydantic.
 
@@ -25,7 +25,8 @@ with distributed implementations (Redis, PostgreSQL, etc.) for production deploy
 ## Channels
 
 - [Channel ABC](api/channel.md): Base class for all channels - handle_inbound, deliver, on_event, capabilities
-- [Built-in Channels](api/channels.md): SMSChannel, EmailChannel, AIChannel, WebSocketChannel, MessengerChannel, HTTPChannel, WhatsAppChannel
+- [Built-in Channels](api/channels.md): SMSChannel, EmailChannel, AIChannel, WebSocketChannel, VoiceChannel, MessengerChannel, HTTPChannel, WhatsAppChannel
+- [Voice Channel](api/providers-voice.md): VoiceBackend ABC, STTProvider, TTSProvider, DeepgramSTTProvider, ElevenLabsTTSProvider, FastRTCVoiceBackend - real-time voice with barge-in support
 
 ## Models
 
@@ -43,6 +44,7 @@ with distributed implementations (Redis, PostgreSQL, etc.) for production deploy
 - [Email Providers](api/providers-email.md): EmailProvider ABC, ElasticEmailProvider
 - [HTTP Providers](api/providers-http.md): HTTPProvider ABC, WebhookHTTPProvider - generic webhook integration
 - [Messenger Providers](api/providers-messenger.md): MessengerProvider ABC, FacebookMessengerProvider
+- [Voice Providers](api/providers-voice.md): VoiceBackend, STTProvider (Deepgram), TTSProvider (ElevenLabs), FastRTCVoiceBackend
 
 ## Optional
 

{roomkit-0.2.0 → roomkit-0.2.1}/llms.txt

@@ -1,7 +1,7 @@
 # RoomKit
 
 > RoomKit is a pure async Python library for building multi-channel conversation systems.
-> It provides room-based abstractions for managing conversations across SMS, Email, WebSocket,
+> It provides room-based abstractions for managing conversations across SMS, Email, Voice, WebSocket,
 > AI, and other channels with pluggable storage, identity resolution, hooks, and realtime events.
 > Python 3.12+, Pydantic 2.x, fully typed, zero required dependencies beyond Pydantic.
 
@@ -25,7 +25,8 @@ with distributed implementations (Redis, PostgreSQL, etc.) for production deploy
 ## Channels
 
 - [Channel ABC](docs/api/channel.md): Base class for all channels - handle_inbound, deliver, on_event, capabilities
-- [Built-in Channels](docs/api/channels.md): SMSChannel, EmailChannel, AIChannel, WebSocketChannel, MessengerChannel, HTTPChannel, WhatsAppChannel
+- [Built-in Channels](docs/api/channels.md): SMSChannel, EmailChannel, AIChannel, WebSocketChannel, VoiceChannel, MessengerChannel, HTTPChannel, WhatsAppChannel
+- [Voice Channel](docs/api/providers-voice.md): VoiceBackend ABC, STTProvider, TTSProvider, DeepgramSTTProvider, ElevenLabsTTSProvider, FastRTCVoiceBackend - real-time voice with barge-in support
 
 ## Models
 
@@ -43,6 +44,7 @@ with distributed implementations (Redis, PostgreSQL, etc.) for production deploy
 - [Email Providers](docs/api/providers-email.md): EmailProvider ABC, ElasticEmailProvider
 - [HTTP Providers](docs/api/providers-http.md): HTTPProvider ABC, WebhookHTTPProvider - generic webhook integration
 - [Messenger Providers](docs/api/providers-messenger.md): MessengerProvider ABC, FacebookMessengerProvider
+- [Voice Providers](docs/api/providers-voice.md): VoiceBackend, STTProvider (Deepgram), TTSProvider (ElevenLabs), FastRTCVoiceBackend
 
 ## Optional
 

roomkit-0.2.1/src/roomkit/_version.py

@@ -0,0 +1 @@
+__version__ = "0.2.1"

{roomkit-0.2.0 → roomkit-0.2.1}/tests/test_public_api.py

@@ -8,7 +8,7 @@ import roomkit
 class TestPublicAPI:
     def test_version_string(self) -> None:
         assert isinstance(roomkit.__version__, str)
-        assert roomkit.__version__ == "0.1.1"
+        assert roomkit.__version__ == "0.2.1"
 
     def test_all_names_importable(self) -> None:
         for name in roomkit.__all__:

roomkit-0.2.0/src/roomkit/_version.py

@@ -1 +0,0 @@
-__version__ = "0.2.0"