roomkit 0.1.1__py3-none-any.whl → 0.2.1__py3-none-any.whl

roomkit/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/__init__.py

@@ -12,6 +12,7 @@ from roomkit.channels import (
 from roomkit.channels.ai import AIChannel
 from roomkit.channels.base import Channel
 from roomkit.channels.transport import TransportChannel
+from roomkit.channels.voice import VoiceChannel
 from roomkit.channels.websocket import WebSocketChannel
 from roomkit.core.framework import (
     ChannelNotFoundError,
@@ -23,6 +24,8 @@ from roomkit.core.framework import (
     RoomNotFoundError,
     SourceAlreadyAttachedError,
     SourceNotFoundError,
+    VoiceBackendNotConfiguredError,
+    VoiceNotConfiguredError,
 )
 from roomkit.core.hooks import HookEngine, HookRegistration
 from roomkit.core.inbound_router import DefaultInboundRoomRouter, InboundRoomRouter
@@ -162,6 +165,26 @@ from roomkit.sources.base import (
 )
 from roomkit.store.base import ConversationStore
 from roomkit.store.memory import InMemoryStore
+from roomkit.voice import (
+    AudioChunk,
+    BargeInEvent,
+    PartialTranscriptionEvent,
+    SpeechEndCallback,
+    SpeechStartCallback,
+    STTProvider,
+    TranscriptionResult,
+    TTSCancelledEvent,
+    TTSProvider,
+    VADAudioLevelEvent,
+    VADSilenceEvent,
+    VoiceBackend,
+    VoiceCapability,
+    VoiceSession,
+    VoiceSessionState,
+)
+from roomkit.voice.backends.mock import MockVoiceBackend
+from roomkit.voice.stt.mock import MockSTTProvider
+from roomkit.voice.tts.mock import MockTTSProvider
 
 # AI documentation helpers (lazy import to avoid file I/O at import time)
 
@@ -199,6 +222,8 @@ __all__ = [
     "IdentityNotFoundError",
     "SourceAlreadyAttachedError",
     "SourceNotFoundError",
+    "VoiceBackendNotConfiguredError",
+    "VoiceNotConfiguredError",
     "RoomLockManager",
     "InMemoryLockManager",
     # Sources (event-driven)
@@ -217,6 +242,7 @@ __all__ = [
     "EmailChannel",
     "RCSChannel",
     "SMSChannel",
+    "VoiceChannel",
     "WebSocketChannel",
     "MessengerChannel",
     "HTTPChannel",
@@ -365,6 +391,25 @@ __all__ = [
     "EphemeralEventType",
     "InMemoryRealtime",
     "RealtimeBackend",
+    # Voice
+    "AudioChunk",
+    "BargeInEvent",
+    "MockSTTProvider",
+    "MockTTSProvider",
+    "MockVoiceBackend",
+    "PartialTranscriptionEvent",
+    "SpeechEndCallback",
+    "SpeechStartCallback",
+    "STTProvider",
+    "TTSCancelledEvent",
+    "TTSProvider",
+    "TranscriptionResult",
+    "VADAudioLevelEvent",
+    "VADSilenceEvent",
+    "VoiceBackend",
+    "VoiceCapability",
+    "VoiceSession",
+    "VoiceSessionState",
     # AI Docs
     "get_agents_md",
     "get_ai_context",

roomkit/_version.py

@@ -1 +1 @@
-__version__ = "0.1.1"
+__version__ = "0.2.1"