effero 0.1.0__py3-none-any.whl

effero/__init__.py

@@ -0,0 +1,26 @@
+"""Effero: one runtime for perceiving, reasoning, and acting across
+computers, robots, and connected devices.
+
+See the top-level README.md for the full architecture and philosophy.
+"""
+
+__version__ = "0.1.0"
+
+
+from typing import Any
+
+
+# Lazy load to avoid cyclic imports or missing dependencies
+def __getattr__(name: str) -> Any:
+    if name == "Agent":
+        from effero.core.agent import Agent
+
+        return Agent
+    if name == "EfferoConfig":
+        from effero.config import EfferoConfig
+
+        return EfferoConfig
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
+
+__all__ = ["Agent", "EfferoConfig"]

effero/adapters/__init__.py

@@ -0,0 +1,21 @@
+"""Effero device adapters.
+
+This package contains various device adapters for communication with IoT devices, robots, cloud APIs, etc.
+"""
+
+from __future__ import annotations
+
+from effero.adapters.base import DeviceAdapter
+from effero.adapters.cloud_api.client import CloudAPIAdapter
+from effero.adapters.mqtt_matter.client import MQTTAdapter, get_default_client
+from effero.adapters.ros2.bridge import ROS2Bridge
+from effero.adapters.serial_gpio.client import SerialAdapter
+
+__all__ = [
+    "DeviceAdapter",
+    "MQTTAdapter",
+    "get_default_client",
+    "SerialAdapter",
+    "CloudAPIAdapter",
+    "ROS2Bridge",
+]

effero/adapters/base.py

@@ -0,0 +1,22 @@
+"""Base interface for device adapters."""
+
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+from typing import Any
+
+
+class DeviceAdapter(ABC):
+    """Base class for all device adapters in the Device Abstraction Layer."""
+
+    @abstractmethod
+    async def connect(self) -> None: ...
+
+    @abstractmethod
+    async def disconnect(self) -> None: ...
+
+    @abstractmethod
+    async def execute(self, command: str, params: dict[str, Any]) -> Any: ...
+
+    @abstractmethod
+    async def read_state(self) -> dict[str, Any]: ...

effero/adapters/cloud_api/__init__.py

@@ -0,0 +1,7 @@
+"""Cloud API adapter module."""
+
+from __future__ import annotations
+
+from effero.adapters.cloud_api.client import CloudAPIAdapter
+
+__all__ = ["CloudAPIAdapter"]

effero/adapters/cloud_api/client.py

@@ -0,0 +1,68 @@
+"""REST API adapter implementation."""
+
+from __future__ import annotations
+
+import logging
+from typing import Any
+
+from effero.adapters.base import DeviceAdapter
+
+logger = logging.getLogger(__name__)
+
+try:
+    import httpx
+
+    HAS_HTTPX = True
+except ImportError:
+    HAS_HTTPX = False
+
+
+class CloudAPIAdapter(DeviceAdapter):
+    """Adapter for interacting with RESTful cloud APIs."""
+
+    def __init__(self, base_url: str, headers: dict[str, str] | None = None, auth_token: str | None = None) -> None:
+        self.base_url = base_url.rstrip("/")
+        self.headers = headers or {}
+        if auth_token:
+            self.headers["Authorization"] = f"Bearer {auth_token}"
+        self._client: Any = None
+        self._last_state: dict[str, Any] = {}
+
+    async def connect(self) -> None:
+        if not HAS_HTTPX:
+            raise RuntimeError("httpx is required for CloudAPIAdapter. Install with: pip install httpx")
+
+        self._client = httpx.AsyncClient(base_url=self.base_url, headers=self.headers)
+        logger.info(f"Cloud API client initialized for {self.base_url}")
+
+    async def disconnect(self) -> None:
+        if self._client:
+            await self._client.aclose()
+            self._client = None
+            logger.info(f"Cloud API client disconnected from {self.base_url}")
+
+    async def execute(self, command: str, params: dict[str, Any]) -> Any:
+        method = params.get("method", "POST").upper()
+        endpoint = params.get("endpoint", "")
+        payload = params.get("payload")
+
+        if self._client:
+            response = await self._client.request(method, endpoint, json=payload)
+            response.raise_for_status()
+            try:
+                data = response.json()
+            except Exception:
+                data = {"text": response.text}
+            return data
+        else:
+            raise RuntimeError("CloudAPIAdapter not connected. Call await adapter.connect() first.")
+
+    async def read_state(self) -> dict[str, Any]:
+        if self._client:
+            try:
+                response = await self._client.get("")
+                response.raise_for_status()
+                self._last_state = response.json()
+            except Exception as e:
+                logger.error(f"Failed to read state: {e}")
+        return self._last_state

effero/adapters/mqtt_matter/__init__.py

@@ -0,0 +1,66 @@
+"""IoT adapter module: Live MQTT 3.1.1 protocol client and Matter commissioning engine."""
+
+from __future__ import annotations
+
+from effero.adapters.mqtt_matter.client import MQTTAdapter, get_default_client, topic_matches
+from effero.adapters.mqtt_matter.matter import (
+    CommissioningState,
+    LevelControlCluster,
+    MatterCommissioningStateMachine,
+    OnboardingPayload,
+    OnOffCluster,
+    TemperatureMeasurementCluster,
+)
+from effero.adapters.mqtt_matter.protocol import (
+    ConnackPacket,
+    ConnectPacket,
+    DisconnectPacket,
+    MQTTPacket,
+    PacketType,
+    PingreqPacket,
+    PingrespPacket,
+    PubackPacket,
+    PubcompPacket,
+    PublishPacket,
+    PubrecPacket,
+    PubrelPacket,
+    SubackPacket,
+    SubscribePacket,
+    UnsubackPacket,
+    UnsubscribePacket,
+    decode_packet,
+    encode_packet,
+)
+from effero.adapters.mqtt_matter.telemetry import NormalizedTelemetry, TelemetryNormalizer
+
+__all__ = [
+    "CommissioningState",
+    "ConnackPacket",
+    "ConnectPacket",
+    "DisconnectPacket",
+    "LevelControlCluster",
+    "MQTTAdapter",
+    "MQTTPacket",
+    "MatterCommissioningStateMachine",
+    "NormalizedTelemetry",
+    "OnOffCluster",
+    "OnboardingPayload",
+    "PacketType",
+    "PingreqPacket",
+    "PingrespPacket",
+    "PubackPacket",
+    "PubcompPacket",
+    "PublishPacket",
+    "PubrecPacket",
+    "PubrelPacket",
+    "SubackPacket",
+    "SubscribePacket",
+    "TelemetryNormalizer",
+    "TemperatureMeasurementCluster",
+    "UnsubackPacket",
+    "UnsubscribePacket",
+    "decode_packet",
+    "encode_packet",
+    "get_default_client",
+    "topic_matches",
+]