dominus-sdk-python 2.10.0__tar.gz → 2.11.0__tar.gz

dominus_sdk_python-2.11.0/PKG-INFO

@@ -0,0 +1,92 @@
+Metadata-Version: 2.4
+Name: dominus-sdk-python
+Version: 2.11.0
+Summary: Python SDK for the Dominus Orchestrator Platform
+Author-email: CareBridge Systems <dev@carebridge.io>
+License: Proprietary
+Project-URL: Homepage, https://github.com/carebridgesystems/dominus-sdk-python
+Project-URL: Repository, https://github.com/carebridgesystems/dominus-sdk-python
+Keywords: dominus,carebridge,sdk,orchestrator,api,async
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: Other/Proprietary License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Framework :: AsyncIO
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.24.0
+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"
+
+# Dominus SDK for Python
+
+Async Python SDK for CareBridge Dominus services. It routes service calls to the Dominus Orchestrator and handles gateway-based JWT minting, base64 encoding, retries, and circuit breaking.
+
+## What This Is
+- Server-side, asyncio-first Python SDK (3.9+)
+- Namespace API plus ultra-flat root shortcuts for common operations
+- Defaults to production orchestrator + gateway endpoints (configurable)
+
+## Quick Start
+```python
+import os
+from dominus import dominus
+
+os.environ["DOMINUS_TOKEN"] = "your-psk-token"
+
+users = await dominus.db.query("users", filters={"status": "active"})
+await dominus.redis.set("session:123", {"user": "john"}, ttl=3600)
+file = await dominus.files.upload(data=buf, filename="report.pdf", category="reports")
+```
+
+## Architecture (SDK View)
+- DOMINUS_TOKEN (PSK) -> Gateway `/jwt/mint` -> JWT cached in `dominus_cache`
+- JSON requests/responses are base64-encoded for auth-required routes
+- GET requests send no body; parameters are in path or POST body
+- Gateway routing is optional per-request; AI namespace always uses gateway
+
+## Namespaces
+- `secrets`, `db`, `secure`, `redis`, `files`, `auth`, `ddl`, `logs`, `portal`, `courier`, `open`, `health`
+- `admin` (reseed/reset admin category)
+- `ai` (agent-runtime: LLM, RAG, artifacts, results, orchestration, speech)
+- `workflow` (workflow-manager CRUD and execution)
+- `oracle` / `stt` (streaming speech-to-text sessions)
+
+## Configuration
+Required:
+- `DOMINUS_TOKEN`
+
+Optional:
+- `DOMINUS_GATEWAY_URL` (default production gateway)
+- `DOMINUS_BASE_URL` (default production orchestrator)
+- `DOMINUS_HTTP_PROXY` / `DOMINUS_HTTPS_PROXY` (httpx proxies)
+
+## Documentation
+- `docs/architecture.md`
+- `docs/namespaces.md`
+- `docs/development.md`
+
+## License
+Proprietary - CareBridge Systems

dominus_sdk_python-2.11.0/README.md

@@ -0,0 +1,50 @@
+# Dominus SDK for Python
+
+Async Python SDK for CareBridge Dominus services. It routes service calls to the Dominus Orchestrator and handles gateway-based JWT minting, base64 encoding, retries, and circuit breaking.
+
+## What This Is
+- Server-side, asyncio-first Python SDK (3.9+)
+- Namespace API plus ultra-flat root shortcuts for common operations
+- Defaults to production orchestrator + gateway endpoints (configurable)
+
+## Quick Start
+```python
+import os
+from dominus import dominus
+
+os.environ["DOMINUS_TOKEN"] = "your-psk-token"
+
+users = await dominus.db.query("users", filters={"status": "active"})
+await dominus.redis.set("session:123", {"user": "john"}, ttl=3600)
+file = await dominus.files.upload(data=buf, filename="report.pdf", category="reports")
+```
+
+## Architecture (SDK View)
+- DOMINUS_TOKEN (PSK) -> Gateway `/jwt/mint` -> JWT cached in `dominus_cache`
+- JSON requests/responses are base64-encoded for auth-required routes
+- GET requests send no body; parameters are in path or POST body
+- Gateway routing is optional per-request; AI namespace always uses gateway
+
+## Namespaces
+- `secrets`, `db`, `secure`, `redis`, `files`, `auth`, `ddl`, `logs`, `portal`, `courier`, `open`, `health`
+- `admin` (reseed/reset admin category)
+- `ai` (agent-runtime: LLM, RAG, artifacts, results, orchestration, speech)
+- `workflow` (workflow-manager CRUD and execution)
+- `oracle` / `stt` (streaming speech-to-text sessions)
+
+## Configuration
+Required:
+- `DOMINUS_TOKEN`
+
+Optional:
+- `DOMINUS_GATEWAY_URL` (default production gateway)
+- `DOMINUS_BASE_URL` (default production orchestrator)
+- `DOMINUS_HTTP_PROXY` / `DOMINUS_HTTPS_PROXY` (httpx proxies)
+
+## Documentation
+- `docs/architecture.md`
+- `docs/namespaces.md`
+- `docs/development.md`
+
+## License
+Proprietary - CareBridge Systems

dominus_sdk_python-2.11.0/dominus/helpers/console_capture.py

@@ -0,0 +1,164 @@
+"""
+Console Capture - Auto-forwards print() and logging.* to Dominus Logs Worker.
+
+Activated by DOMINUS_CAPTURE_CONSOLE=true environment variable.
+Preserves original output and never throws errors.
+
+Usage:
+    # Automatic (via env var):
+    # Set DOMINUS_CAPTURE_CONSOLE=true before importing SDK
+
+    # Manual:
+    from dominus import dominus
+    dominus.capture_console()     # start capturing
+    dominus.release_console()     # stop capturing
+"""
+import asyncio
+import builtins
+import logging
+import sys
+from typing import Optional, TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from ..namespaces.logs import LogsNamespace
+
+_installed = False
+_logs_ref: Optional["LogsNamespace"] = None
+_original_print = builtins.print
+_log_handler: Optional["DominusLogHandler"] = None
+
+# Guard against re-entrant calls (fallback_log uses print to stderr)
+_sending = False
+
+
+def _format_args(args: tuple, kwargs: dict) -> str:
+    """Format print-style arguments into a single string."""
+    sep = kwargs.get("sep", " ")
+    parts = []
+    for arg in args:
+        if arg is None:
+            parts.append("None")
+        elif isinstance(arg, Exception):
+            parts.append(f"{type(arg).__name__}: {arg}")
+        elif isinstance(arg, (dict, list)):
+            try:
+                import json
+                parts.append(json.dumps(arg, default=str))
+            except Exception:
+                parts.append(str(arg))
+        else:
+            parts.append(str(arg))
+    return sep.join(parts)
+
+
+def _fire_log(level: str, message: str) -> None:
+    """Fire-and-forget log to Dominus Logs Worker. Never blocks, never throws."""
+    global _sending
+    if _sending or not _logs_ref:
+        return
+    _sending = True
+
+    async def _send():
+        global _sending
+        try:
+            if level == "debug":
+                await _logs_ref.debug(message, {"source": "console"}, "console")
+            elif level == "info":
+                await _logs_ref.info(message, {"source": "console"}, "console")
+            elif level == "warn":
+                await _logs_ref.warn(message, {"source": "console"}, "console")
+            elif level == "error":
+                await _logs_ref.error(message, {"source": "console"}, "console")
+        except Exception:
+            pass
+        finally:
+            _sending = False
+
+    # Try to schedule in the running event loop, fall back silently
+    try:
+        loop = asyncio.get_running_loop()
+        loop.create_task(_send())
+    except RuntimeError:
+        # No running event loop - skip (can't do async without one)
+        _sending = False
+
+
+def _patched_print(*args, **kwargs):
+    """Replacement print() that also sends to Logs Worker."""
+    # Always call original print first
+    _original_print(*args, **kwargs)
+
+    # Determine if this is stderr output (which may be fallback logging)
+    file = kwargs.get("file")
+    if file is sys.stderr:
+        # Don't capture stderr prints (likely fallback logs - avoid loop)
+        return
+
+    message = _format_args(args, kwargs)
+    _fire_log("info", message)
+
+
+class DominusLogHandler(logging.Handler):
+    """Logging handler that forwards records to Dominus Logs Worker."""
+
+    def emit(self, record: logging.LogRecord) -> None:
+        # Map Python log levels to Dominus levels
+        level_map = {
+            "DEBUG": "debug",
+            "INFO": "info",
+            "WARNING": "warn",
+            "ERROR": "error",
+            "CRITICAL": "error",
+        }
+        level = level_map.get(record.levelname, "info")
+        message = self.format(record)
+        _fire_log(level, message)
+
+
+def install_console_capture(logs: "LogsNamespace") -> None:
+    """
+    Install console capture wrappers.
+    Call this after LogsNamespace is initialized.
+
+    Args:
+        logs: The LogsNamespace instance to forward logs to
+    """
+    global _installed, _logs_ref, _log_handler
+
+    if _installed:
+        return
+
+    _logs_ref = logs
+    _installed = True
+
+    # Patch builtins.print
+    builtins.print = _patched_print
+
+    # Install logging handler on root logger
+    _log_handler = DominusLogHandler()
+    _log_handler.setLevel(logging.DEBUG)
+    logging.getLogger().addHandler(_log_handler)
+
+
+def uninstall_console_capture() -> None:
+    """Remove console capture wrappers, restoring original behavior."""
+    global _installed, _logs_ref, _log_handler
+
+    if not _installed:
+        return
+
+    _installed = False
+    _logs_ref = None
+
+    # Restore original print
+    builtins.print = _original_print
+
+    # Remove logging handler
+    if _log_handler is not None:
+        logging.getLogger().removeHandler(_log_handler)
+        _log_handler = None
+
+
+def is_console_capture_active() -> bool:
+    """Check if console capture is currently active."""
+    return _installed

{dominus_sdk_python-2.10.0 → dominus_sdk_python-2.11.0}/dominus/namespaces/auth.py

@@ -81,17 +81,28 @@ class AuthNamespace:
         limit: int = 100,
         offset: int = 0,
         order_by: str = "created_at",
-        order_desc: bool = True
+        order_desc: bool = True,
+        include_system: bool = False
     ) -> Dict[str, Any]:
         """
         List users with optional filters.
 
+        Args:
+            status: Filter by user status (e.g. 'active')
+            limit: Maximum rows to return
+            offset: Rows to skip
+            order_by: Column to order by
+            order_desc: Sort descending
+            include_system: Include system (super admin) users in results
+
         Returns:
             Dict with "items" list and "total" count
         """
         params = f"?limit={limit}&offset={offset}&order_by={order_by}&order_desc={str(order_desc).lower()}"
         if status:
             params += f"&status={status}"
+        if include_system:
+            params += "&include_system=true"
 
         return await self._client._request(
             endpoint=f"/api/guardian/users{params}",

{dominus_sdk_python-2.10.0 → dominus_sdk_python-2.11.0}/dominus/start.py

@@ -362,6 +362,28 @@ class Dominus:
         # Cache for JWT public key
         self._public_key_cache = None
 
+        # Auto-activate console capture if env var is set
+        if os.environ.get("DOMINUS_CAPTURE_CONSOLE") == "true":
+            from .helpers.console_capture import install_console_capture
+            install_console_capture(self.logs)
+
+    def capture_console(self) -> None:
+        """Start capturing print() and logging.* and forwarding to Dominus Logs Worker.
+        Original output is preserved (original functions still called)."""
+        from .helpers.console_capture import install_console_capture
+        install_console_capture(self.logs)
+
+    def release_console(self) -> None:
+        """Stop capturing console output. Restores original print() and removes log handler."""
+        from .helpers.console_capture import uninstall_console_capture
+        uninstall_console_capture()
+
+    @property
+    def is_capturing_console(self) -> bool:
+        """Check if console capture is currently active."""
+        from .helpers.console_capture import is_console_capture_active
+        return is_console_capture_active()
+
     # ========================================
     # INTERNAL REQUEST METHOD (for user JWT)
     # ========================================

dominus_sdk_python-2.11.0/dominus_sdk_python.egg-info/PKG-INFO

@@ -0,0 +1,92 @@
+Metadata-Version: 2.4
+Name: dominus-sdk-python
+Version: 2.11.0
+Summary: Python SDK for the Dominus Orchestrator Platform
+Author-email: CareBridge Systems <dev@carebridge.io>
+License: Proprietary
+Project-URL: Homepage, https://github.com/carebridgesystems/dominus-sdk-python
+Project-URL: Repository, https://github.com/carebridgesystems/dominus-sdk-python
+Keywords: dominus,carebridge,sdk,orchestrator,api,async
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: Other/Proprietary License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Framework :: AsyncIO
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.24.0
+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"
+
+# Dominus SDK for Python
+
+Async Python SDK for CareBridge Dominus services. It routes service calls to the Dominus Orchestrator and handles gateway-based JWT minting, base64 encoding, retries, and circuit breaking.
+
+## What This Is
+- Server-side, asyncio-first Python SDK (3.9+)
+- Namespace API plus ultra-flat root shortcuts for common operations
+- Defaults to production orchestrator + gateway endpoints (configurable)
+
+## Quick Start
+```python
+import os
+from dominus import dominus
+
+os.environ["DOMINUS_TOKEN"] = "your-psk-token"
+
+users = await dominus.db.query("users", filters={"status": "active"})
+await dominus.redis.set("session:123", {"user": "john"}, ttl=3600)
+file = await dominus.files.upload(data=buf, filename="report.pdf", category="reports")
+```
+
+## Architecture (SDK View)
+- DOMINUS_TOKEN (PSK) -> Gateway `/jwt/mint` -> JWT cached in `dominus_cache`
+- JSON requests/responses are base64-encoded for auth-required routes
+- GET requests send no body; parameters are in path or POST body
+- Gateway routing is optional per-request; AI namespace always uses gateway
+
+## Namespaces
+- `secrets`, `db`, `secure`, `redis`, `files`, `auth`, `ddl`, `logs`, `portal`, `courier`, `open`, `health`
+- `admin` (reseed/reset admin category)
+- `ai` (agent-runtime: LLM, RAG, artifacts, results, orchestration, speech)
+- `workflow` (workflow-manager CRUD and execution)
+- `oracle` / `stt` (streaming speech-to-text sessions)
+
+## Configuration
+Required:
+- `DOMINUS_TOKEN`
+
+Optional:
+- `DOMINUS_GATEWAY_URL` (default production gateway)
+- `DOMINUS_BASE_URL` (default production orchestrator)
+- `DOMINUS_HTTP_PROXY` / `DOMINUS_HTTPS_PROXY` (httpx proxies)
+
+## Documentation
+- `docs/architecture.md`
+- `docs/namespaces.md`
+- `docs/development.md`
+
+## License
+Proprietary - CareBridge Systems

{dominus_sdk_python-2.10.0 → dominus_sdk_python-2.11.0}/dominus_sdk_python.egg-info/SOURCES.txt

@@ -8,6 +8,7 @@ dominus/config/endpoints.py
 dominus/helpers/__init__.py
 dominus/helpers/auth.py
 dominus/helpers/cache.py
+dominus/helpers/console_capture.py
 dominus/helpers/core.py
 dominus/helpers/crypto.py
 dominus/helpers/sse.py

{dominus_sdk_python-2.10.0 → dominus_sdk_python-2.11.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "dominus-sdk-python"
-version = "2.10.0"
+version = "2.11.0"
 description = "Python SDK for the Dominus Orchestrator Platform"
 readme = "README.md"
 license = {text = "Proprietary"}