afferens 0.1.0__tar.gz

afferens-0.1.0/PKG-INFO

@@ -0,0 +1,8 @@
+Metadata-Version: 2.4
+Name: afferens
+Version: 0.1.0
+Summary: Afferens Python SDK — Universal Sensory Layer for AI agents
+Project-URL: Homepage, https://afferens.vercel.app
+Project-URL: Documentation, https://afferens.vercel.app/docs
+Requires-Python: >=3.8
+Requires-Dist: requests>=2.28

afferens-0.1.0/afferens/__init__.py

@@ -0,0 +1,4 @@
+from .client import Afferens
+
+__all__ = ["Afferens"]
+__version__ = "0.1.0"

afferens-0.1.0/afferens/client.py

@@ -0,0 +1,109 @@
+import requests
+from typing import Optional, Literal
+
+BASE_URL = "https://afferens.vercel.app"
+
+Modality = Literal["VISION", "SPATIAL", "ACOUSTIC", "ENVIRONMENTAL", "MOLECULAR", "INTEROCEPTION"]
+
+
+class AfferensError(Exception):
+    def __init__(self, status: int, message: str):
+        self.status = status
+        self.message = message
+        super().__init__(f"[{status}] {message}")
+
+
+class Afferens:
+    """
+    Afferens Python SDK — Universal Sensory Layer for AI agents.
+
+    Usage:
+        from afferens import Afferens
+        client = Afferens(api_key="AFF-77-YOURNAME")
+        data = client.perceive(modality="VISION")
+    """
+
+    def __init__(self, api_key: str, base_url: str = BASE_URL):
+        self.api_key = api_key
+        self.base_url = base_url.rstrip("/")
+        self._session = requests.Session()
+        self._session.headers.update({"X-API-KEY": self.api_key})
+
+    def perceive(
+        self,
+        modality: Optional[Modality] = None,
+        limit: int = 1,
+    ) -> dict:
+        """
+        Query the Afferens sensory API.
+
+        Args:
+            modality: One of VISION, SPATIAL, ACOUSTIC, ENVIRONMENTAL, MOLECULAR, INTEROCEPTION.
+                      Omit to retrieve all modalities.
+            limit: Number of events to return (max 10).
+
+        Returns:
+            dict with keys: status, data, count, api_version
+        """
+        params = {"limit": min(limit, 10)}
+        if modality:
+            params["modality"] = modality.upper()
+
+        response = self._session.get(f"{self.base_url}/api/perception", params=params)
+        result = response.json()
+
+        if response.status_code != 200:
+            raise AfferensError(result.get("status", response.status_code), result.get("error", "Unknown error"))
+
+        return result
+
+    def ingest(
+        self,
+        modality: Modality,
+        data: dict,
+        classification: Optional[str] = None,
+    ) -> dict:
+        """
+        Push live sensor data into the Afferens API from this node.
+
+        Args:
+            modality: Sensor type — VISION, SPATIAL, etc.
+            data: Raw sensor payload as a dict.
+            classification: Optional label for this reading.
+
+        Returns:
+            dict with entity_id, modality, sense_tokens_consumed
+        """
+        body = {"modality": modality.upper(), "data": data}
+        if classification:
+            body["classification"] = classification
+
+        response = self._session.post(
+            f"{self.base_url}/api/ingest",
+            json=body,
+            headers={"Content-Type": "application/json"},
+        )
+        result = response.json()
+
+        if response.status_code != 200:
+            raise AfferensError(result.get("status", response.status_code), result.get("error", "Unknown error"))
+
+        return result
+
+    def vision(self, limit: int = 1) -> dict:
+        return self.perceive(modality="VISION", limit=limit)
+
+    def spatial(self, limit: int = 1) -> dict:
+        return self.perceive(modality="SPATIAL", limit=limit)
+
+    def acoustic(self, limit: int = 1) -> dict:
+        return self.perceive(modality="ACOUSTIC", limit=limit)
+
+    def environmental(self, limit: int = 1) -> dict:
+        return self.perceive(modality="ENVIRONMENTAL", limit=limit)
+
+    def molecular(self, limit: int = 1) -> dict:
+        return self.perceive(modality="MOLECULAR", limit=limit)
+
+    def interoception(self, limit: int = 1) -> dict:
+        return self.perceive(modality="INTEROCEPTION", limit=limit)

afferens-0.1.0/afferens.egg-info/PKG-INFO

@@ -0,0 +1,8 @@
+Metadata-Version: 2.4
+Name: afferens
+Version: 0.1.0
+Summary: Afferens Python SDK — Universal Sensory Layer for AI agents
+Project-URL: Homepage, https://afferens.vercel.app
+Project-URL: Documentation, https://afferens.vercel.app/docs
+Requires-Python: >=3.8
+Requires-Dist: requests>=2.28

afferens-0.1.0/afferens.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+pyproject.toml
+afferens/__init__.py
+afferens/client.py
+afferens.egg-info/PKG-INFO
+afferens.egg-info/SOURCES.txt
+afferens.egg-info/dependency_links.txt
+afferens.egg-info/requires.txt
+afferens.egg-info/top_level.txt

afferens-0.1.0/afferens.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

afferens-0.1.0/afferens.egg-info/requires.txt

@@ -0,0 +1 @@
+requests>=2.28

afferens-0.1.0/afferens.egg-info/top_level.txt

@@ -0,0 +1 @@
+afferens

afferens-0.1.0/pyproject.toml

@@ -0,0 +1,14 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "afferens"
+version = "0.1.0"
+description = "Afferens Python SDK — Universal Sensory Layer for AI agents"
+requires-python = ">=3.8"
+dependencies = ["requests>=2.28"]
+
+[project.urls]
+Homepage = "https://afferens.vercel.app"
+Documentation = "https://afferens.vercel.app/docs"

afferens-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+