agentic-yp 1.0.0__py3-none-any.whl

agentic_yp/__init__.py

@@ -0,0 +1,9 @@
+from .client import (
+    AgenticYPClient, 
+    AgentNode, 
+    AgenticYPError, 
+    AgentNotFoundError, 
+    AgenticYPAPIError
+)
+
+__version__ = "1.0.0"

agentic_yp/client.py

@@ -0,0 +1,161 @@
+import time
+import logging
+from dataclasses import dataclass, field
+from typing import List, Optional
+from importlib.metadata import version, PackageNotFoundError
+
+import requests
+
+logger = logging.getLogger(__name__)
+
+# ── Custom exceptions ──────────────────────────────────────────────────────────
+
+class AgenticYPError(Exception):
+    """Base exception for all SDK errors."""
+
+class AgentNotFoundError(AgenticYPError):
+    """No agent matched the given filters."""
+
+class AgenticYPAPIError(AgenticYPError):
+    """The API returned an unexpected response."""
+    def __init__(self, status_code: int, message: str):
+        self.status_code = status_code
+        super().__init__(f"API error {status_code}: {message}")
+
+# ── Typed agent node ───────────────────────────────────────────────────────────
+
+@dataclass
+class AgentNode:
+    domain: str
+    trust_score: int
+    status: str
+    tags: List[str] = field(default_factory=list)
+    raw: dict = field(default_factory=dict, repr=False)
+
+    @classmethod
+    def from_dict(cls, data: dict) -> "AgentNode":
+        return cls(
+            domain=data.get("domain", ""),
+            trust_score=data.get("trust_score", 0),
+            status=data.get("status", "unknown"),
+            tags=[str(t).lower() for t in data.get("tags", [])],
+            raw=data,
+        )
+
+    def execute(self, prompt: str, **kwargs) -> dict:
+        """Route a prompt directly to this agent's endpoint."""
+        url = f"https://{self.domain}/run"
+        resp = requests.post(url, json={"prompt": prompt, **kwargs}, timeout=30)
+        resp.raise_for_status()
+        return resp.json()
+
+# ── Main client ────────────────────────────────────────────────────────────────
+
+try:
+    _SDK_VERSION = version("agentic-yp")
+except PackageNotFoundError:
+    _SDK_VERSION = "dev"
+
+class AgenticYPClient:
+    """
+    Official Python SDK for Agentic Yellow Pages.
+    Discover, filter, and route to trusted A2A endpoints programmatically.
+    """
+
+    DEFAULT_MIN_TRUST = 70
+    _cache: Optional[List[dict]] = None
+    _cache_ts: float = 0
+    CACHE_TTL = 30  # seconds
+
+    def __init__(
+        self,
+        base_url: str = "https://agentic-yellow-pages.onrender.com",
+        timeout: int = 10,
+        cache_ttl: int = 30,
+    ):
+        self.base_url = base_url.rstrip("/")
+        self.timeout = timeout
+        self.CACHE_TTL = cache_ttl
+        self.session = requests.Session()
+        self.session.headers.update({
+            "User-Agent": f"AgenticYP-Python-SDK/{_SDK_VERSION}"
+        })
+
+    def _fetch_all(self, force_refresh: bool = False) -> List[dict]:
+        """Fetches the global index, with TTL caching."""
+        now = time.monotonic()
+        if not force_refresh and self._cache and (now - self._cache_ts) < self.CACHE_TTL:
+            logger.debug("Returning cached agent list (%d agents)", len(self._cache))
+            return self._cache
+
+        try:
+            res = self.session.get(f"{self.base_url}/agents", timeout=self.timeout)
+            res.raise_for_status()
+        except requests.Timeout:
+            raise AgenticYPError(f"Request timed out after {self.timeout}s")
+        except requests.HTTPError as e:
+            raise AgenticYPAPIError(e.response.status_code, str(e))
+        except requests.RequestException as e:
+            raise AgenticYPError(f"Network error: {e}")
+
+        try:
+            data = res.json()
+            agents = data.get("agents", []) if isinstance(data, dict) else data
+        except ValueError:
+            raise AgenticYPAPIError(res.status_code, "Response was not valid JSON")
+
+        self._cache = agents
+        self._cache_ts = now
+        logger.debug("Fetched %d agents from API", len(agents))
+        return agents
+
+    def discover(
+        self,
+        skill: Optional[str] = None,
+        min_trust_score: int = DEFAULT_MIN_TRUST,
+        require_online: bool = True,
+        require_a2a_verified: bool = False,
+    ) -> List[AgentNode]:
+        """
+        Find nodes matching your requirements.
+
+        :param skill:               Tag/capability to filter on (e.g. 'search', 'mcp-server').
+        :param min_trust_score:     Minimum Oracle trust score (0-100). Default: 70.
+        :param require_online:      Exclude offline nodes.
+        :param require_a2a_verified: Only return deeply verified A2A nodes.
+        :returns:                   List of AgentNode, sorted by trust score descending.
+        """
+        nodes = self._fetch_all()
+        results = []
+
+        for raw in nodes:
+            node = AgentNode.from_dict(raw)
+
+            if require_online and node.status == "offline":
+                continue
+            if require_a2a_verified and node.status != "a2a_verified":
+                continue
+            if node.trust_score < min_trust_score:
+                continue
+            if skill and skill.lower() not in node.tags:
+                continue
+
+            results.append(node)
+
+        return sorted(results, key=lambda n: n.trust_score, reverse=True)
+
+    def get_top_node(
+        self,
+        skill: str,
+        min_trust_score: int = DEFAULT_MIN_TRUST,
+    ) -> AgentNode:
+        """
+        Returns the single highest-rated node for a skill.
+        Raises AgentNotFoundError if nothing matches.
+        """
+        nodes = self.discover(skill=skill, min_trust_score=min_trust_score)
+        if not nodes:
+            raise AgentNotFoundError(
+                f"No online agent found for skill='{skill}' with trust >= {min_trust_score}"
+            )
+        return nodes[0]

agentic_yp-1.0.0.dist-info/METADATA

@@ -0,0 +1,33 @@
+Metadata-Version: 2.4
+Name: agentic-yp
+Version: 1.0.0
+Summary: Official SDK for the Agentic Yellow Pages A2A routing network.
+Author-email: Agentic YP <admin@agenticyellowpage.com>
+Project-URL: Homepage, https://agenticyellowpage.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.25.0
+
+# Agentic Yellow Pages SDK 📒🤖
+
+The official SDK for the [Agentic Yellow Pages](https://agenticyellowpage.com) — the discovery and trust routing layer for the machine-to-machine (M2M) economy.
+
+Stop hardcoding agent endpoints. Use this SDK to dynamically discover, filter, and route data to A2A endpoints based on their cryptographic **Trust Score**, live health metrics, and capabilities.
+
+## Usage (Python)
+
+```python
+from agentic_yp import AgenticYPClient
+
+yp = AgenticYPClient()
+
+# Automatically discover the safest, highest-rated web scraper
+scraper_node = yp.get_top_node(skill="web-crawler", min_trust_score=90)
+
+print(f"Routing to {scraper_node.domain} (Score: {scraper_node.trust_score})")
+
+# Execute a payload directly to the node
+response = scraper_node.execute(prompt="Scrape the latest AI news")

agentic_yp-1.0.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+agentic_yp/__init__.py,sha256=Fa3DKFtBQThv6PNuPTAdetM-s0LSZiSdM5NVKGMfRAk,160
+agentic_yp/client.py,sha256=VN_xw8qwgQzFh1jjEq5NA4D371o1ZqGpL-pgnTml51c,6071
+agentic_yp-1.0.0.dist-info/METADATA,sha256=wBpMJppevqPt4A7vPbC_aA1W3RsZSrPn1yruxQVzHUw,1325
+agentic_yp-1.0.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+agentic_yp-1.0.0.dist-info/top_level.txt,sha256=eRPrj6E2iC5W3cjB1sA1CGb0R5zrqeUkUhSKyWgIGj0,11
+agentic_yp-1.0.0.dist-info/RECORD,,

agentic_yp-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

agentic_yp-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+agentic_yp