dominus-sdk-python 2.3.0__tar.gz → 2.5.0__tar.gz

{dominus_sdk_python-2.3.0 → dominus_sdk_python-2.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dominus-sdk-python
-Version: 2.3.0
+Version: 2.5.0
 Summary: Python SDK for the Dominus Orchestrator Platform
 Author-email: CareBridge Systems <dev@carebridge.io>
 License: Proprietary
@@ -25,9 +25,20 @@ Requires-Dist: bcrypt>=4.0.0
 Requires-Dist: cryptography>=41.0.0
 Provides-Extra: jwt
 Requires-Dist: PyJWT>=2.8.0; extra == "jwt"
+Provides-Extra: oracle
+Requires-Dist: websockets>=12.0; extra == "oracle"
+Requires-Dist: sounddevice>=0.4.6; extra == "oracle"
+Requires-Dist: numpy>=1.24.0; extra == "oracle"
+Requires-Dist: webrtcvad>=2.0.10; extra == "oracle"
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Provides-Extra: all
+Requires-Dist: PyJWT>=2.8.0; extra == "all"
+Requires-Dist: websockets>=12.0; extra == "all"
+Requires-Dist: sounddevice>=0.4.6; extra == "all"
+Requires-Dist: numpy>=1.24.0; extra == "all"
+Requires-Dist: webrtcvad>=2.0.10; extra == "all"
 
 # CB Dominus SDK for Python
 
@@ -417,8 +428,8 @@ from dominus import (
     ConflictError,
     ServiceError,
     SecureTableError,
-    ConnectionError,
-    TimeoutError,
+    DominusConnectionError,  # Renamed to avoid shadowing built-in
+    DominusTimeoutError,     # Renamed to avoid shadowing built-in
 )
 
 try:
@@ -445,6 +456,7 @@ except DominusError as e:
 
 | Error | Status | Description |
 |-------|--------|-------------|
+| `DominusError` | - | Base class for all SDK errors |
 | `AuthenticationError` | 401 | Invalid or missing token |
 | `AuthorizationError` | 403 | Insufficient permissions |
 | `NotFoundError` | 404 | Resource not found |
@@ -452,8 +464,8 @@ except DominusError as e:
 | `ConflictError` | 409 | Duplicate or version conflict |
 | `ServiceError` | 5xx | Backend service error |
 | `SecureTableError` | 403 | Missing reason for secure table |
-| `ConnectionError` | - | Network connection failed |
-| `TimeoutError` | 504 | Request timed out |
+| `DominusConnectionError` | - | Network connection failed |
+| `DominusTimeoutError` | 504 | Request timed out |
 
 ## Configuration
 
@@ -551,10 +563,13 @@ async def get_all_users(page_size: int = 100):
 
 ## Version
 
-**v2.1.6** - Latest release with navigation routes and page scope methods
+**v2.4.0** - Full namespace parity with Node.js SDK
 
 ### Changelog
 
+- **v2.4.0** - Full parity with Node.js SDK: all namespaces properly initialized, error classes exported, cache utilities exposed
+- **v2.3.0** - Add comprehensive auth namespace with 100+ methods
+- **v2.2.0** - Add DDL schema builder and migration methods
 - **v2.1.6** - Fix navigation routes and add page scope methods
 - **v2.1.5** - Add PSK-only client login
 - **v2.1.4** - Make `tenant_id` optional in login methods

{dominus_sdk_python-2.3.0 → dominus_sdk_python-2.5.0}/README.md

@@ -386,8 +386,8 @@ from dominus import (
     ConflictError,
     ServiceError,
     SecureTableError,
-    ConnectionError,
-    TimeoutError,
+    DominusConnectionError,  # Renamed to avoid shadowing built-in
+    DominusTimeoutError,     # Renamed to avoid shadowing built-in
 )
 
 try:
@@ -414,6 +414,7 @@ except DominusError as e:
 
 | Error | Status | Description |
 |-------|--------|-------------|
+| `DominusError` | - | Base class for all SDK errors |
 | `AuthenticationError` | 401 | Invalid or missing token |
 | `AuthorizationError` | 403 | Insufficient permissions |
 | `NotFoundError` | 404 | Resource not found |
@@ -421,8 +422,8 @@ except DominusError as e:
 | `ConflictError` | 409 | Duplicate or version conflict |
 | `ServiceError` | 5xx | Backend service error |
 | `SecureTableError` | 403 | Missing reason for secure table |
-| `ConnectionError` | - | Network connection failed |
-| `TimeoutError` | 504 | Request timed out |
+| `DominusConnectionError` | - | Network connection failed |
+| `DominusTimeoutError` | 504 | Request timed out |
 
 ## Configuration
 
@@ -520,10 +521,13 @@ async def get_all_users(page_size: int = 100):
 
 ## Version
 
-**v2.1.6** - Latest release with navigation routes and page scope methods
+**v2.4.0** - Full namespace parity with Node.js SDK
 
 ### Changelog
 
+- **v2.4.0** - Full parity with Node.js SDK: all namespaces properly initialized, error classes exported, cache utilities exposed
+- **v2.3.0** - Add comprehensive auth namespace with 100+ methods
+- **v2.2.0** - Add DDL schema builder and migration methods
 - **v2.1.6** - Fix navigation routes and add page scope methods
 - **v2.1.5** - Add PSK-only client login
 - **v2.1.4** - Make `tenant_id` optional in login methods

{dominus_sdk_python-2.3.0 → dominus_sdk_python-2.5.0}/dominus/__init__.py

@@ -8,6 +8,10 @@ Ultra-Flat API:
     value = await dominus.get("DB_URL")
     await dominus.upsert("KEY", "value")
 
+    # Secrets namespace
+    value = await dominus.secrets.get("DB_URL")
+    await dominus.secrets.upsert("KEY", "value")
+
     # Database (namespace-based)
     tables = await dominus.db.tables()
     rows = await dominus.db.query("users", filters={"status": "active"})
@@ -23,6 +27,16 @@ Ultra-Flat API:
     # Files (namespace-based)
     result = await dominus.files.upload(data=file_bytes, filename="report.pdf", category="reports")
 
+    # Redis caching
+    await dominus.redis.set("key", "value", ttl=3600)
+    value = await dominus.redis.get("key")
+
+    # Logging
+    await dominus.logs.info("Operation complete", {"user_id": user_id})
+
+    # Email
+    await dominus.courier.send("welcome", to="user@example.com", from_email="hello@app.com", model={})
+
     # Secure table access with audit logging
     rows = await dominus.db_secure.query("patients", context=SecureAccessContext(
         reason="Reviewing chart",
@@ -35,11 +49,14 @@ Ultra-Flat API:
     # Portal authentication
     session = await dominus.portal.login("user@example.com", "password", "tenant-id")
 
-    # Open DSN
+    # Open DSN and raw SQL
     dsn = await dominus.open.dsn()
+    result = await dominus.open.execute("SELECT * FROM users WHERE id = $1", {"1": user_id})
 
     # Health
     status = await dominus.health.check()
+    await dominus.health.ping()
+    await dominus.health.warmup()
 
 Backward Compatible APIs:
     # String-based API
@@ -76,11 +93,45 @@ from .namespaces.files import FilesNamespace
 from .namespaces.portal import PortalNamespace
 from .namespaces.admin import AdminNamespace
 from .namespaces.secure import SecureNamespace, SecureAccessContext
+from .namespaces.secrets import SecretsNamespace
+from .namespaces.redis import RedisNamespace
+from .namespaces.logs import LogsNamespace
+from .namespaces.courier import CourierNamespace
+from .namespaces.health import HealthNamespace
+from .namespaces.open import OpenNamespace
+
+# Export Oracle namespace for speech-to-text
+from .namespaces.oracle import (
+    OracleNamespace,
+    OracleSession,
+    OracleSessionOptions,
+    VADState,
+)
+
+# Export cache and resilience utilities
+from .helpers.cache import (
+    dominus_cache,
+    CircuitBreaker,
+    DominusCache,
+    orchestrator_circuit_breaker,
+    exponential_backoff_with_jitter,
+)
 
-# Export cache utilities
-from .helpers.cache import dominus_cache
+# Export error classes
+from .errors import (
+    DominusError,
+    AuthenticationError,
+    AuthorizationError,
+    NotFoundError,
+    ValidationError,
+    ConflictError,
+    ServiceError,
+    SecureTableError,
+    ConnectionError as DominusConnectionError,
+    TimeoutError as DominusTimeoutError,
+)
 
-__version__ = "2.2.0"
+__version__ = "2.5.0"
 __all__ = [
     # Main SDK instance
     "dominus",
@@ -103,6 +154,32 @@ __all__ = [
     "AdminNamespace",
     "SecureNamespace",
     "SecureAccessContext",
-    # Cache utilities
+    "SecretsNamespace",
+    "RedisNamespace",
+    "LogsNamespace",
+    "CourierNamespace",
+    "HealthNamespace",
+    "OpenNamespace",
+    # Oracle namespace for speech-to-text
+    "OracleNamespace",
+    "OracleSession",
+    "OracleSessionOptions",
+    "VADState",
+    # Cache and resilience utilities
     "dominus_cache",
+    "CircuitBreaker",
+    "DominusCache",
+    "orchestrator_circuit_breaker",
+    "exponential_backoff_with_jitter",
+    # Error classes
+    "DominusError",
+    "AuthenticationError",
+    "AuthorizationError",
+    "NotFoundError",
+    "ValidationError",
+    "ConflictError",
+    "ServiceError",
+    "SecureTableError",
+    "DominusConnectionError",
+    "DominusTimeoutError",
 ]

{dominus_sdk_python-2.3.0 → dominus_sdk_python-2.5.0}/dominus/helpers/cache.py

@@ -1,7 +1,12 @@
 """
 Internal cache with automatic encryption and circuit breaker.
 
-NOT exposed to SDK users - internal use only.
+Exports:
+    - CircuitBreaker: Circuit breaker class for resilience
+    - DominusCache: Encrypted cache class
+    - dominus_cache: Singleton cache instance
+    - orchestrator_circuit_breaker: Circuit breaker for orchestrator
+    - exponential_backoff_with_jitter: Backoff calculation utility
 """
 import time
 import json
@@ -181,12 +186,15 @@ class DominusCache:
         return count
 
 
-# Internal singletons - NOT exported to users
+# Singleton instances
 dominus_cache = DominusCache(default_ttl=300)
 
-# Circuit breakers for different services (prevents retry storms)
-sovereign_circuit_breaker = CircuitBreaker(
+# Circuit breaker for orchestrator (prevents retry storms)
+orchestrator_circuit_breaker = CircuitBreaker(
     failure_threshold=5,    # Open after 5 consecutive failures
     recovery_timeout=30.0,  # Try again after 30 seconds
     half_open_max_calls=1   # Allow 1 test call in half-open state
 )
+
+# Backward compatibility alias
+sovereign_circuit_breaker = orchestrator_circuit_breaker

dominus_sdk_python-2.5.0/dominus/namespaces/oracle/__init__.py

@@ -0,0 +1,120 @@
+"""
+Oracle Namespace - Real-time streaming speech-to-text.
+
+Provides WebSocket-based streaming transcription via Deepgram,
+with built-in VAD (Voice Activity Detection) for cost optimization.
+
+Key features:
+- Automatic microphone capture and 16kHz resampling
+- VAD gating: only sends audio when speech is detected
+- 4-state VAD machine: IDLE -> ARMED -> SPEAKING -> TRAILING
+- Pre-roll buffer captures word onsets
+- Ping/pong keepalive during IDLE
+- NO send_audio() exposed - VAD handles everything
+
+Usage:
+    session = dominus.oracle.create_session(user_jwt)
+
+    session.on_ready = lambda: set_listening(True)
+    session.on_interim = lambda text: set_live_transcript(text)
+    session.on_utterance = lambda text: send_to_curator(text)
+    session.on_vad_state_change = lambda state: set_mic_state(state)
+    session.on_error = lambda error: show_error(error)
+
+    await session.start()
+    # ... user speaks, transcripts flow back ...
+    await session.stop()
+"""
+
+from typing import Optional, TYPE_CHECKING
+
+from .types import (
+    VADState,
+    OracleSessionOptions,
+    ResolvedOracleSessionOptions,
+    DEFAULT_OPTIONS,
+    AUDIO_CONFIG,
+)
+from .session import OracleSession
+
+if TYPE_CHECKING:
+    from ...start import Dominus
+
+# Re-export public types
+__all__ = [
+    "OracleNamespace",
+    "OracleSession",
+    "OracleSessionOptions",
+    "VADState",
+]
+
+
+class OracleNamespace:
+    """
+    OracleNamespace - Factory for creating streaming transcription sessions.
+
+    The Oracle namespace provides a simple API for real-time speech-to-text:
+    - create_session() creates a new transcription session
+    - Sessions handle mic capture, VAD, WebSocket, and transcripts internally
+    - NO raw audio access - VAD is mandatory for cost control
+    """
+
+    def __init__(self, client: "Dominus"):
+        from ...config.endpoints import BASE_URL
+        self._base_url = BASE_URL
+        self._client = client
+
+    def create_session(
+        self,
+        user_token: str,
+        options: Optional[OracleSessionOptions] = None
+    ) -> OracleSession:
+        """
+        Create a streaming transcription session.
+
+        The session handles everything internally:
+        - Microphone access and audio capture
+        - Resampling to 16kHz mono PCM
+        - VAD gating (only sends speech, not silence)
+        - WebSocket connection to Oracle
+        - Reconnection on connection loss
+
+        Args:
+            user_token: User JWT from portal.login()
+            options: Optional configuration overrides
+
+        Returns:
+            OracleSession ready to start()
+
+        Example:
+            session = dominus.oracle.create_session(user_jwt, OracleSessionOptions(
+                preroll_ms=320,      # Capture 320ms before speech
+                postroll_ms=400,     # Continue 400ms after speech
+                armed_confirm_ms=80, # Require 80ms to confirm speech
+            ))
+
+            session.on_utterance = lambda text: send_to_curator(text)
+
+            await session.start()
+        """
+        # Merge options with defaults
+        if options:
+            resolved_options = ResolvedOracleSessionOptions(
+                preroll_ms=options.preroll_ms if options.preroll_ms != DEFAULT_OPTIONS.preroll_ms else DEFAULT_OPTIONS.preroll_ms,
+                postroll_ms=options.postroll_ms if options.postroll_ms != DEFAULT_OPTIONS.postroll_ms else DEFAULT_OPTIONS.postroll_ms,
+                armed_confirm_ms=options.armed_confirm_ms if options.armed_confirm_ms != DEFAULT_OPTIONS.armed_confirm_ms else DEFAULT_OPTIONS.armed_confirm_ms,
+                vad_threshold=options.vad_threshold if options.vad_threshold != DEFAULT_OPTIONS.vad_threshold else DEFAULT_OPTIONS.vad_threshold,
+                energy_threshold=options.energy_threshold if options.energy_threshold != DEFAULT_OPTIONS.energy_threshold else DEFAULT_OPTIONS.energy_threshold,
+                ping_interval_ms=options.ping_interval_ms if options.ping_interval_ms != DEFAULT_OPTIONS.ping_interval_ms else DEFAULT_OPTIONS.ping_interval_ms,
+            )
+        else:
+            resolved_options = ResolvedOracleSessionOptions(
+                preroll_ms=DEFAULT_OPTIONS.preroll_ms,
+                postroll_ms=DEFAULT_OPTIONS.postroll_ms,
+                armed_confirm_ms=DEFAULT_OPTIONS.armed_confirm_ms,
+                vad_threshold=DEFAULT_OPTIONS.vad_threshold,
+                energy_threshold=DEFAULT_OPTIONS.energy_threshold,
+                ping_interval_ms=DEFAULT_OPTIONS.ping_interval_ms,
+            )
+
+        return OracleSession(self._base_url, user_token, resolved_options)