nodus-sdk 0.1.0__tar.gz

nodus_sdk-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shawn Knight
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

nodus_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,231 @@
+Metadata-Version: 2.4
+Name: nodus-sdk
+Version: 0.1.0
+Summary: Unified platform SDK for Nodus — factory, bridges, and integration layer
+Author: Shawn Knight
+License: MIT License
+        
+        Copyright (c) 2026 Shawn Knight
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/Masterplanner25/nodus-sdk
+Project-URL: Repository, https://github.com/Masterplanner25/nodus-sdk
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: nodus-lang>=4.0.0
+Requires-Dist: nodus-schema>=0.1.0
+Requires-Dist: nodus-protocol>=0.1.0
+Requires-Dist: nodus-retry>=0.1.0
+Provides-Extra: agent
+Requires-Dist: nodus-agent>=0.1.0; extra == "agent"
+Requires-Dist: nodus-state>=0.1.0; extra == "agent"
+Requires-Dist: nodus-circuit-breaker>=0.1.0; extra == "agent"
+Provides-Extra: workflow
+Requires-Dist: nodus-workflow>=0.1.0; extra == "workflow"
+Requires-Dist: nodus-state>=0.1.0; extra == "workflow"
+Requires-Dist: nodus-events>=0.1.0; extra == "workflow"
+Provides-Extra: memory
+Requires-Dist: nodus-memory>=0.1.0; extra == "memory"
+Provides-Extra: memory-ai
+Requires-Dist: nodus-memory[openai]>=0.1.0; extra == "memory-ai"
+Provides-Extra: auth
+Requires-Dist: nodus-auth>=0.1.0; extra == "auth"
+Provides-Extra: llm
+Requires-Dist: nodus-llm>=0.1.0; extra == "llm"
+Requires-Dist: nodus-circuit-breaker>=0.1.0; extra == "llm"
+Provides-Extra: http
+Requires-Dist: nodus-http>=0.1.0; extra == "http"
+Provides-Extra: redis
+Requires-Dist: nodus-queue[redis]>=0.1.0; extra == "redis"
+Requires-Dist: nodus-events[redis]>=0.1.0; extra == "redis"
+Provides-Extra: sql
+Requires-Dist: sqlalchemy>=2.0; extra == "sql"
+Provides-Extra: vector
+Requires-Dist: pgvector>=0.2; extra == "vector"
+Requires-Dist: sqlalchemy>=2.0; extra == "vector"
+Provides-Extra: scheduler
+Requires-Dist: apscheduler>=3.10; extra == "scheduler"
+Provides-Extra: fastapi
+Requires-Dist: fastapi>=0.100; extra == "fastapi"
+Requires-Dist: httpx>=0.27; extra == "fastapi"
+Provides-Extra: webhooks
+Requires-Dist: httpx>=0.27; extra == "webhooks"
+Provides-Extra: observability
+Requires-Dist: nodus-observability>=0.1.0; extra == "observability"
+Requires-Dist: nodus-observability-framework>=0.1.0; extra == "observability"
+Provides-Extra: extensions
+Requires-Dist: nodus-extension>=0.1.0; extra == "extensions"
+Provides-Extra: full
+Requires-Dist: nodus-sdk[agent,auth,extensions,fastapi,http,llm,memory,observability,redis,scheduler,sql,vector,webhooks,workflow]; extra == "full"
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+Requires-Dist: pytest-asyncio; extra == "dev"
+Requires-Dist: respx; extra == "dev"
+Requires-Dist: fastapi[all]; extra == "dev"
+Requires-Dist: sqlalchemy>=2.0; extra == "dev"
+Requires-Dist: apscheduler>=3.10; extra == "dev"
+Requires-Dist: httpx>=0.27; extra == "dev"
+Dynamic: license-file
+
+# nodus-sdk
+
+**Unified platform SDK for Nodus AI systems.**
+
+Single-package installation story for the Nodus ecosystem. Auto-wires
+available packages via `create_runtime(**kwargs)`, provides 9 bridge modules
+for external integrations, and exposes a FastAPI control-plane router.
+
+> **Status:** v0.1.0 — prepared, not yet published.
+
+---
+
+## Install
+
+```bash
+pip install nodus-sdk                            # core only
+pip install "nodus-sdk[agent,sql,fastapi]"       # agent + SQLAlchemy + FastAPI
+pip install "nodus-sdk[full]"                    # everything
+```
+
+---
+
+## Quick start
+
+```python
+from nodus_sdk import create_runtime
+
+rt = create_runtime(memory=True, trace_id="req-001", timeout_ms=None)
+result = rt.run_source('print("hello from sdk")')
+```
+
+---
+
+## create_runtime()
+
+```python
+from nodus_sdk import create_runtime, NodusSDKRuntime
+
+rt = create_runtime(
+    memory=True,          # True = auto-configure; or pass a store object
+    events=True,          # True = auto-configure; or pass EventBusConfig
+    extensions=True,      # attach ExtensionRegistry
+    auth=True,            # attach KeyRing
+    observability=True,   # or pass service name string
+    trace_id="tid-001",   # injected into every emitted event
+    timeout_ms=None,      # None = unlimited (required for long-lived services)
+    max_steps=None,
+    allowed_paths=None,
+    project_root=None,
+)
+```
+
+`create_runtime` returns a `NodusSDKRuntime` — a `NodusRuntime` subclass with
+fluent `attach_*` bridge methods. All capability kwargs accept `True` (default
+config) or a config/store object.
+
+---
+
+## NodusSDKRuntime fluent API
+
+```python
+from nodus_sdk import NodusSDKRuntime
+from nodus_sdk.bridges.sql import SqlBridge
+from nodus_sdk.bridges.webhook import WebhookBridge
+
+rt = (
+    NodusSDKRuntime(timeout_ms=None)
+    .attach_sql(SqlBridge("postgresql://..."))
+    .attach_webhook(WebhookBridge(secret="my-secret"))
+)
+```
+
+All `attach_*` methods are idempotent and return `self`.
+
+---
+
+## Bridges
+
+| Bridge | Install extra | Key class |
+|---|---|---|
+| `bridges/redis.py` | `[redis]` | `RedisBridge(url)` → queue_backend, event_bus |
+| `bridges/http.py` | `[http]` | `HttpBridge()` → NodusHttpClient |
+| `bridges/llm.py` | `[llm]` | `LLMBridge(credentials)` → FailoverClient |
+| `bridges/observability.py` | `[observability]` | `init_observability(name, otel=, prometheus=)` |
+| `bridges/sql.py` | `[sql]` | `SqlBridge(url)` → sql_query/sql_execute host fns |
+| `bridges/vector.py` | `[vector]` | `VectorBridge(url, table, dimensions)` → vector_search/upsert/delete |
+| `bridges/scheduler.py` | `[scheduler]` | `SchedulerBridge()` → scheduler_add_interval/cron/cancel |
+| `bridges/webhook.py` | `[webhooks]` | `WebhookBridge(secret=)` → webhook_send |
+| `bridges/api.py` | `[fastapi]` | `create_nodus_router(rt)` + `NodusTraceMiddleware` |
+
+**Bridge return type note:** Bridge host functions return Python maps (dicts),
+not Records. Use index access in `.nd` code: `r["status"]`, not `r.status`.
+
+---
+
+## FastAPI integration
+
+```python
+from fastapi import FastAPI
+from nodus_sdk import create_runtime
+from nodus_sdk.bridges.api import create_nodus_router, NodusTraceMiddleware
+
+rt = create_runtime(timeout_ms=None)
+app = FastAPI()
+app.add_middleware(NodusTraceMiddleware, runtime=rt)
+app.include_router(create_nodus_router(rt))
+# Routes: POST /run, GET /health, GET /syscalls, GET|POST|DELETE /memory/{key}
+```
+
+---
+
+## detect_available()
+
+```python
+from nodus_sdk import detect_available
+
+avail = detect_available()
+# {"memory": True, "extension": False, "events": True, ...}
+```
+
+---
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+PYTHONPATH="C:/dev/Coding Language/src" pytest tests/ -q
+```
+
+Tests require nodus-lang source on `PYTHONPATH`.
+
+---
+
+## License
+
+MIT — see [LICENSE](LICENSE).

nodus_sdk-0.1.0/README.md

@@ -0,0 +1,136 @@
+# nodus-sdk
+
+**Unified platform SDK for Nodus AI systems.**
+
+Single-package installation story for the Nodus ecosystem. Auto-wires
+available packages via `create_runtime(**kwargs)`, provides 9 bridge modules
+for external integrations, and exposes a FastAPI control-plane router.
+
+> **Status:** v0.1.0 — prepared, not yet published.
+
+---
+
+## Install
+
+```bash
+pip install nodus-sdk                            # core only
+pip install "nodus-sdk[agent,sql,fastapi]"       # agent + SQLAlchemy + FastAPI
+pip install "nodus-sdk[full]"                    # everything
+```
+
+---
+
+## Quick start
+
+```python
+from nodus_sdk import create_runtime
+
+rt = create_runtime(memory=True, trace_id="req-001", timeout_ms=None)
+result = rt.run_source('print("hello from sdk")')
+```
+
+---
+
+## create_runtime()
+
+```python
+from nodus_sdk import create_runtime, NodusSDKRuntime
+
+rt = create_runtime(
+    memory=True,          # True = auto-configure; or pass a store object
+    events=True,          # True = auto-configure; or pass EventBusConfig
+    extensions=True,      # attach ExtensionRegistry
+    auth=True,            # attach KeyRing
+    observability=True,   # or pass service name string
+    trace_id="tid-001",   # injected into every emitted event
+    timeout_ms=None,      # None = unlimited (required for long-lived services)
+    max_steps=None,
+    allowed_paths=None,
+    project_root=None,
+)
+```
+
+`create_runtime` returns a `NodusSDKRuntime` — a `NodusRuntime` subclass with
+fluent `attach_*` bridge methods. All capability kwargs accept `True` (default
+config) or a config/store object.
+
+---
+
+## NodusSDKRuntime fluent API
+
+```python
+from nodus_sdk import NodusSDKRuntime
+from nodus_sdk.bridges.sql import SqlBridge
+from nodus_sdk.bridges.webhook import WebhookBridge
+
+rt = (
+    NodusSDKRuntime(timeout_ms=None)
+    .attach_sql(SqlBridge("postgresql://..."))
+    .attach_webhook(WebhookBridge(secret="my-secret"))
+)
+```
+
+All `attach_*` methods are idempotent and return `self`.
+
+---
+
+## Bridges
+
+| Bridge | Install extra | Key class |
+|---|---|---|
+| `bridges/redis.py` | `[redis]` | `RedisBridge(url)` → queue_backend, event_bus |
+| `bridges/http.py` | `[http]` | `HttpBridge()` → NodusHttpClient |
+| `bridges/llm.py` | `[llm]` | `LLMBridge(credentials)` → FailoverClient |
+| `bridges/observability.py` | `[observability]` | `init_observability(name, otel=, prometheus=)` |
+| `bridges/sql.py` | `[sql]` | `SqlBridge(url)` → sql_query/sql_execute host fns |
+| `bridges/vector.py` | `[vector]` | `VectorBridge(url, table, dimensions)` → vector_search/upsert/delete |
+| `bridges/scheduler.py` | `[scheduler]` | `SchedulerBridge()` → scheduler_add_interval/cron/cancel |
+| `bridges/webhook.py` | `[webhooks]` | `WebhookBridge(secret=)` → webhook_send |
+| `bridges/api.py` | `[fastapi]` | `create_nodus_router(rt)` + `NodusTraceMiddleware` |
+
+**Bridge return type note:** Bridge host functions return Python maps (dicts),
+not Records. Use index access in `.nd` code: `r["status"]`, not `r.status`.
+
+---
+
+## FastAPI integration
+
+```python
+from fastapi import FastAPI
+from nodus_sdk import create_runtime
+from nodus_sdk.bridges.api import create_nodus_router, NodusTraceMiddleware
+
+rt = create_runtime(timeout_ms=None)
+app = FastAPI()
+app.add_middleware(NodusTraceMiddleware, runtime=rt)
+app.include_router(create_nodus_router(rt))
+# Routes: POST /run, GET /health, GET /syscalls, GET|POST|DELETE /memory/{key}
+```
+
+---
+
+## detect_available()
+
+```python
+from nodus_sdk import detect_available
+
+avail = detect_available()
+# {"memory": True, "extension": False, "events": True, ...}
+```
+
+---
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+PYTHONPATH="C:/dev/Coding Language/src" pytest tests/ -q
+```
+
+Tests require nodus-lang source on `PYTHONPATH`.
+
+---
+
+## License
+
+MIT — see [LICENSE](LICENSE).

nodus_sdk-0.1.0/nodus_sdk/__init__.py

@@ -0,0 +1,12 @@
+"""nodus-sdk — unified platform SDK for Nodus."""
+
+from nodus_sdk._version import __version__
+from nodus_sdk.factory import create_runtime, detect_available
+from nodus_sdk.runtime import NodusSDKRuntime
+
+__all__ = [
+    "__version__",
+    "NodusSDKRuntime",
+    "create_runtime",
+    "detect_available",
+]

nodus_sdk-0.1.0/nodus_sdk/_version.py

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

nodus_sdk-0.1.0/nodus_sdk/bridges/__init__.py

@@ -0,0 +1 @@
+"""nodus_sdk.bridges — Python bridge implementations."""

nodus_sdk-0.1.0/nodus_sdk/bridges/api.py

@@ -0,0 +1,124 @@
+"""FastAPI bridge — NodusRuntime router and trace middleware."""
+
+from __future__ import annotations
+
+import importlib.util
+from typing import TYPE_CHECKING, Any, Optional
+
+_FASTAPI_AVAILABLE = importlib.util.find_spec("fastapi") is not None
+
+if TYPE_CHECKING:
+    from nodus.runtime.embedding import NodusRuntime
+
+if _FASTAPI_AVAILABLE:
+    from pydantic import BaseModel
+
+    class _RunRequest(BaseModel):
+        source: str
+        timeout_ms: Optional[int] = None
+
+    class _MemoryWriteRequest(BaseModel):
+        value: Any
+
+
+def create_nodus_router(
+    runtime: "NodusRuntime",
+    *,
+    prefix: str = "",
+    tags: list[str] | None = None,
+    include_memory: bool = True,
+    include_syscalls: bool = True,
+) -> Any:
+    """Return a FastAPI APIRouter with Nodus control-plane endpoints.
+
+    Routes:
+      POST  {prefix}/run              — run Nodus source code
+      GET   {prefix}/health           — runtime health
+      GET   {prefix}/syscalls         — list sys.v1.* syscalls
+      GET   {prefix}/memory/{key}     — read from memory store
+      POST  {prefix}/memory/{key}     — write to memory store
+      DELETE{prefix}/memory/{key}     — delete from memory store
+
+    Requires ``nodus-sdk[fastapi]``.
+    """
+    if not _FASTAPI_AVAILABLE:
+        raise ImportError("fastapi not installed. pip install nodus-sdk[fastapi]")
+
+    from fastapi import APIRouter
+
+    from nodus.support.version import __version__ as nodus_version
+
+    router = APIRouter(prefix=prefix, tags=tags or ["nodus"])
+
+    @router.post("/run")
+    def run_source(req: _RunRequest) -> dict:
+        result = runtime.run_source(req.source)
+        return {
+            "ok": result.get("ok", False),
+            "stdout": result.get("stdout", ""),
+            "stderr": result.get("stderr", ""),
+            "error": result.get("error"),
+        }
+
+    @router.get("/health")
+    def health() -> dict:
+        return {"ok": True, "version": nodus_version}
+
+    if include_syscalls:
+        @router.get("/syscalls")
+        def list_syscalls() -> list:
+            try:
+                from nodus.services.syscall_runtime import list_syscalls as _list
+                return _list()
+            except ImportError:
+                return []
+
+    if include_memory:
+        @router.get("/memory/{key}")
+        def memory_get(key: str) -> dict:
+            from nodus.services.memory_runtime import get_value
+            value = get_value(key)
+            return {"key": key, "value": value}
+
+        @router.post("/memory/{key}")
+        def memory_set(key: str, req: _MemoryWriteRequest) -> dict:
+            from nodus.services.memory_runtime import put_value
+            stored = put_value(key, req.value)
+            return {"key": key, "value": stored}
+
+        @router.delete("/memory/{key}")
+        def memory_delete(key: str) -> dict:
+            from nodus.services.memory_runtime import delete_value
+            found = delete_value(key)
+            return {"key": key, "found": found}
+
+    return router
+
+
+class NodusTraceMiddleware:
+    """ASGI middleware that injects X-Trace-ID into NodusRuntime before each request.
+
+    Usage::
+
+        app = FastAPI()
+        rt = create_runtime()
+        app.add_middleware(NodusTraceMiddleware, runtime=rt)
+
+    Requires ``nodus-sdk[fastapi]``.
+    """
+
+    def __init__(self, app: Any, *, runtime: "NodusRuntime", header: str = "X-Trace-ID") -> None:
+        self.app = app
+        self.runtime = runtime
+        self.header = header.lower().encode()
+
+    async def __call__(self, scope: dict, receive: Any, send: Any) -> None:
+        if scope["type"] == "http":
+            trace_id = None
+            for name, value in scope.get("headers", []):
+                if name.lower() == self.header:
+                    trace_id = value.decode()
+                    break
+            if trace_id:
+                self.runtime.set_trace_id(trace_id)
+        await self.app(scope, receive, send)

nodus_sdk-0.1.0/nodus_sdk/bridges/http.py

@@ -0,0 +1,42 @@
+"""HttpBridge — thin bridge over nodus-http."""
+
+from __future__ import annotations
+
+import importlib.util
+from typing import Any
+
+_AVAILABLE = importlib.util.find_spec("nodus_http") is not None
+
+
+class HttpBridge:
+    """Thin bridge wrapping nodus-http's HttpClient with optional circuit-breaker.
+
+    Requires ``nodus-sdk[http]`` (``nodus-http``).
+    """
+
+    def __init__(
+        self,
+        base_url: str | None = None,
+        timeout: float = 30.0,
+        circuit_breaker: Any = None,
+        retry_config: Any = None,
+    ) -> None:
+        self._base_url = base_url
+        self._timeout = timeout
+        self._circuit_breaker = circuit_breaker
+        self._retry_config = retry_config
+
+    def available(self) -> bool:
+        return _AVAILABLE
+
+    def client(self) -> Any:
+        """Return a configured NodusHttpClient."""
+        if not _AVAILABLE:
+            raise ImportError("nodus-http not installed. pip install nodus-sdk[http]")
+        from nodus_http import NodusHttpClient
+        kwargs: dict[str, Any] = {}
+        if self._base_url:
+            kwargs["base_url"] = self._base_url
+        if self._circuit_breaker is not None:
+            kwargs["circuit_breaker"] = self._circuit_breaker
+        return NodusHttpClient(**kwargs)

nodus_sdk-0.1.0/nodus_sdk/bridges/llm.py

@@ -0,0 +1,44 @@
+"""LLMBridge — thin bridge over nodus-llm's FailoverClient."""
+
+from __future__ import annotations
+
+import importlib.util
+from typing import Any
+
+_AVAILABLE = importlib.util.find_spec("nodus_llm") is not None
+
+
+class LLMBridge:
+    """Thin bridge wrapping nodus-llm for multi-provider LLM failover.
+
+    Requires ``nodus-sdk[llm]`` (``nodus-llm``).
+    """
+
+    def __init__(self, credentials: list[Any] | None = None) -> None:
+        self._credentials = credentials or []
+
+    def available(self) -> bool:
+        return _AVAILABLE
+
+    def failover_client(self, provider_fn: Any = None) -> Any:
+        """Return a FailoverClient configured with provided credentials.
+
+        provider_fn maps CredentialProfile → LLMClient. Required by nodus-llm;
+        pass a callable that constructs a provider-specific client.
+        """
+        if not _AVAILABLE:
+            raise ImportError("nodus-llm not installed. pip install nodus-sdk[llm]")
+        if provider_fn is None:
+            raise ValueError(
+                "provider_fn is required: pass a callable that maps CredentialProfile → LLMClient"
+            )
+        from nodus_llm import FailoverClient, CredentialStore
+        store = CredentialStore(profiles=self._credentials)
+        return FailoverClient(store, provider_fn)
+
+    def credential_store(self) -> Any:
+        """Return a CredentialStore from the provided credential profiles."""
+        if not _AVAILABLE:
+            raise ImportError("nodus-llm not installed. pip install nodus-sdk[llm]")
+        from nodus_llm import CredentialStore
+        return CredentialStore(profiles=self._credentials)

nodus_sdk-0.1.0/nodus_sdk/bridges/observability.py

@@ -0,0 +1,51 @@
+"""Observability bridge — thin wrapper over nodus-observability bootstrap."""
+
+from __future__ import annotations
+
+import importlib.util
+
+_AVAILABLE = importlib.util.find_spec("nodus_observability") is not None
+
+
+def available() -> bool:
+    return _AVAILABLE
+
+
+def init_observability(
+    service_name: str,
+    *,
+    otel: bool = False,
+    prometheus: bool = False,
+    configure_logging: bool = True,
+) -> None:
+    """Bootstrap observability for the given service.
+
+    Calls nodus-observability's init_otel() and/or create_registry() depending
+    on the flags. Safe to call multiple times (subsequent calls are no-ops at
+    the nodus-observability layer).
+
+    Requires ``nodus-sdk[observability]``.
+    """
+    if not _AVAILABLE:
+        return
+
+    if configure_logging:
+        try:
+            from nodus_observability import configure_logging as _conf_logging
+            _conf_logging()
+        except (ImportError, TypeError):
+            pass
+
+    if otel:
+        try:
+            from nodus_observability import init_otel
+            init_otel(service_name)
+        except (ImportError, TypeError):
+            pass
+
+    if prometheus:
+        try:
+            from nodus_observability import create_registry
+            create_registry()
+        except (ImportError, TypeError):
+            pass