agent0-sdk 0.2.1__tar.gz → 0.3rc1__tar.gz

{agent0_sdk-0.2.1 → agent0_sdk-0.3rc1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent0-sdk
-Version: 0.2.1
+Version: 0.3rc1
 Summary: Python SDK for agent portability, discovery and trust based on ERC-8004
 Author-email: Marco De Rossi <marco.derossi@consensys.net>
 License: MIT License
@@ -47,13 +47,12 @@ Requires-Dist: eth-account>=0.8.0
 Requires-Dist: requests>=2.28.0
 Requires-Dist: pydantic>=2.0.0
 Requires-Dist: ipfshttpclient>=0.8.0a2
-Requires-Dist: numpy>=1.21.0
-Requires-Dist: scikit-learn>=1.0.0
-Requires-Dist: sentence-transformers>=2.2.0
 Requires-Dist: aiohttp>=3.8.0
 Requires-Dist: asyncio-throttle>=1.0.0
 Requires-Dist: python-dotenv>=1.0.0
 Requires-Dist: typing-extensions>=4.0.0
+Provides-Extra: indexer
+Requires-Dist: sentence-transformers>=2.2.0; extra == "indexer"
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
@@ -275,7 +274,6 @@ agent.register("https://example.com/agent-registration.json")
 
 - More chains (currently Ethereum Sepolia only)
 - Support for validations
-- Multi-chain agents search
 - Enhanced x402 payments
 - Semantic/Vectorial search
 - Advanced reputation aggregation

{agent0_sdk-0.2.1 → agent0_sdk-0.3rc1}/README.md

@@ -204,7 +204,6 @@ agent.register("https://example.com/agent-registration.json")
 
 - More chains (currently Ethereum Sepolia only)
 - Support for validations
-- Multi-chain agents search
 - Enhanced x402 payments
 - Semantic/Vectorial search
 - Advanced reputation aggregation

{agent0_sdk-0.2.1 → agent0_sdk-0.3rc1}/agent0_sdk/__init__.py

@@ -30,7 +30,7 @@ except ImportError:
     Agent = None
     _sdk_available = False
 
-__version__ = "0.2.1"
+__version__ = "0.3rc1"
 __all__ = [
     "SDK",
     "Agent",

{agent0_sdk-0.2.1 → agent0_sdk-0.3rc1}/agent0_sdk/core/contracts.py

@@ -477,6 +477,11 @@ DEFAULT_REGISTRIES: Dict[int, Dict[str, str]] = {
         "REPUTATION": "0x8004bd8daB57f14Ed299135749a5CB5c42d341BF",
         "VALIDATION": "0x8004C269D0A5647E51E121FeB226200ECE932d55",
     },
+    80002: {  # Polygon Amoy
+        "IDENTITY": "0x8004ad19E14B9e0654f73353e8a0B600D46C2898",
+        "REPUTATION": "0x8004B12F4C2B42d00c46479e859C92e39044C930",
+        "VALIDATION": "0x8004C11C213ff7BaD36489bcBDF947ba5eee289B",
+    },
     59141: {  # Linea Sepolia
         "IDENTITY": "0x8004aa7C931bCE1233973a0C6A667f73F66282e7",
         "REPUTATION": "0x8004bd8483b99310df121c46ED8858616b2Bba02",
@@ -487,4 +492,6 @@ DEFAULT_REGISTRIES: Dict[int, Dict[str, str]] = {
 # Default subgraph URLs for different chains
 DEFAULT_SUBGRAPH_URLS: Dict[int, str] = {
     11155111: "https://gateway.thegraph.com/api/00a452ad3cd1900273ea62c1bf283f93/subgraphs/id/6wQRC7geo9XYAhckfmfo8kbMRLeWU8KQd3XsJqFKmZLT",  # Ethereum Sepolia
+    84532: "https://gateway.thegraph.com/api/00a452ad3cd1900273ea62c1bf283f93/subgraphs/id/GjQEDgEKqoh5Yc8MUgxoQoRATEJdEiH7HbocfR1aFiHa",  # Base Sepolia
+    80002: "https://gateway.thegraph.com/api/00a452ad3cd1900273ea62c1bf283f93/subgraphs/id/2A1JB18r1mF2VNP4QBH4mmxd74kbHoM6xLXC8ABAKf7j",  # Polygon Amoy
 }

{agent0_sdk-0.2.1 → agent0_sdk-0.3rc1}/agent0_sdk/core/endpoint_crawler.py

@@ -178,13 +178,13 @@ class EndpointCrawler:
     def fetch_a2a_capabilities(self, endpoint: str) -> Optional[Dict[str, Any]]:
         """
         Fetch A2A capabilities (skills) from an A2A server.
-        
+
         A2A Protocol uses agent cards to describe agent capabilities.
-        Tries multiple well-known paths: agentcard.json, .well-known/agent.json
-        
+        Tries multiple well-known paths: agentcard.json, .well-known/agent.json, .well-known/agent-card.json
+
         Args:
             endpoint: A2A endpoint URL (must be http:// or https://)
-            
+
         Returns:
             Dict with key: 'a2aSkills'
             Returns None if unable to fetch
@@ -194,37 +194,97 @@ class EndpointCrawler:
             if not endpoint.startswith(('http://', 'https://')):
                 logger.warning(f"A2A endpoint must be HTTP/HTTPS, got: {endpoint}")
                 return None
-            
+
             # Try multiple well-known paths for A2A agent cards
+            # Per ERC-8004, endpoint may already be full URL to agent card
+            # Per A2A spec section 5.3, recommended discovery path is /.well-known/agent-card.json
             agentcard_urls = [
-                f"{endpoint}/agentcard.json",
-                f"{endpoint}/.well-known/agent.json",
-                f"{endpoint.rstrip('/')}/.well-known/agent.json"
+                endpoint,  # Try exact URL first (ERC-8004 format: full path to agent card)
+                f"{endpoint}/.well-known/agent-card.json",  # Spec-recommended discovery path
+                f"{endpoint.rstrip('/')}/.well-known/agent-card.json",
+                f"{endpoint}/.well-known/agent.json",  # Alternative well-known path
+                f"{endpoint.rstrip('/')}/.well-known/agent.json",
+                f"{endpoint}/agentcard.json"  # Legacy path
             ]
-            
+
             for agentcard_url in agentcard_urls:
                 logger.debug(f"Attempting to fetch A2A capabilities from {agentcard_url}")
-                
+
                 try:
                     response = requests.get(agentcard_url, timeout=self.timeout, allow_redirects=True)
-                    
+
                     if response.status_code == 200:
                         data = response.json()
-                        
-                        # Extract skills from agentcard
-                        skills = self._extract_list(data, 'skills')
-                        
+
+                        # Extract skill tags from agentcard
+                        skills = self._extract_a2a_skills(data)
+
                         if skills:
-                            logger.info(f"Successfully fetched A2A capabilities from {endpoint}")
+                            logger.info(f"Successfully fetched A2A capabilities from {agentcard_url}: {len(skills)} skills")
                             return {'a2aSkills': skills}
-                except requests.exceptions.RequestException:
+                except requests.exceptions.RequestException as e:
                     # Try next URL
+                    logger.debug(f"Failed to fetch from {agentcard_url}: {e}")
                     continue
-                    
+
         except Exception as e:
             logger.debug(f"Unexpected error fetching A2A capabilities from {endpoint}: {e}")
-        
+
         return None
+
+    def _extract_a2a_skills(self, data: Dict[str, Any]) -> List[str]:
+        """
+        Extract skill tags from A2A agent card.
+
+        Per A2A Protocol spec (v0.3.0), agent cards should have:
+          skills: AgentSkill[] where each AgentSkill has a tags[] array
+
+        This method also handles non-standard formats for backward compatibility:
+        - detailedSkills[].tags[] (custom extension)
+        - skills: ["tag1", "tag2"] (non-compliant flat array)
+
+        Args:
+            data: Agent card JSON data
+
+        Returns:
+            List of unique skill tags (strings)
+        """
+        result = []
+
+        # Try spec-compliant format first: skills[].tags[]
+        if 'skills' in data and isinstance(data['skills'], list):
+            for skill in data['skills']:
+                if isinstance(skill, dict) and 'tags' in skill:
+                    # Spec-compliant: AgentSkill object with tags
+                    tags = skill['tags']
+                    if isinstance(tags, list):
+                        for tag in tags:
+                            if isinstance(tag, str):
+                                result.append(tag)
+                elif isinstance(skill, str):
+                    # Non-compliant: flat string array (fallback)
+                    result.append(skill)
+
+        # Fallback to detailedSkills if no tags found in skills
+        # (custom extension used by some implementations)
+        if not result and 'detailedSkills' in data and isinstance(data['detailedSkills'], list):
+            for skill in data['detailedSkills']:
+                if isinstance(skill, dict) and 'tags' in skill:
+                    tags = skill['tags']
+                    if isinstance(tags, list):
+                        for tag in tags:
+                            if isinstance(tag, str):
+                                result.append(tag)
+
+        # Remove duplicates while preserving order
+        seen = set()
+        unique_result = []
+        for item in result:
+            if item not in seen:
+                seen.add(item)
+                unique_result.append(item)
+
+        return unique_result
     
     def _extract_list(self, data: Dict[str, Any], key: str) -> List[str]:
         """

{agent0_sdk-0.2.1 → agent0_sdk-0.3rc1}/agent0_sdk/core/feedback_manager.py

@@ -703,7 +703,46 @@ class FeedbackManager:
         groupBy: Optional[List[str]] = None,
     ) -> Dict[str, Any]:
         """Get reputation summary for an agent with optional grouping."""
-        # Parse agent ID
+        # Parse chainId from agentId
+        chain_id = None
+        if ":" in agentId:
+            try:
+                chain_id = int(agentId.split(":", 1)[0])
+            except ValueError:
+                chain_id = None
+        
+        # Try subgraph first (if available and indexer supports it)
+        if self.indexer and self.subgraph_client:
+            # Get correct subgraph client for the chain
+            subgraph_client = None
+            full_agent_id = agentId
+            
+            if chain_id is not None:
+                subgraph_client = self.indexer._get_subgraph_client_for_chain(chain_id)
+            else:
+                # No chainId in agentId, use SDK's default
+                # Construct full agentId format for subgraph query
+                default_chain_id = self.web3_client.chain_id
+                token_id = agentId.split(":")[-1] if ":" in agentId else agentId
+                full_agent_id = f"{default_chain_id}:{token_id}"
+                subgraph_client = self.subgraph_client
+            
+            if subgraph_client:
+                # Use subgraph to calculate reputation
+                return self._get_reputation_summary_from_subgraph(
+                    full_agent_id, clientAddresses, tag1, tag2, groupBy
+                )
+        
+        # Fallback to blockchain (requires chain-specific web3 client)
+        # For now, only works if chain matches SDK's default
+        if chain_id is not None and chain_id != self.web3_client.chain_id:
+            raise ValueError(
+                f"Blockchain reputation summary not supported for chain {chain_id}. "
+                f"SDK is configured for chain {self.web3_client.chain_id}. "
+                f"Use subgraph-based summary instead."
+            )
+        
+        # Parse agent ID for blockchain call
         if ":" in agentId:
             tokenId = int(agentId.split(":")[-1])
         else:
@@ -765,6 +804,67 @@ class FeedbackManager:
         except Exception as e:
             raise ValueError(f"Failed to get reputation summary: {e}")
     
+    def _get_reputation_summary_from_subgraph(
+        self,
+        agentId: AgentId,
+        clientAddresses: Optional[List[Address]] = None,
+        tag1: Optional[str] = None,
+        tag2: Optional[str] = None,
+        groupBy: Optional[List[str]] = None,
+    ) -> Dict[str, Any]:
+        """Get reputation summary from subgraph."""
+        # Build tags list
+        tags = []
+        if tag1:
+            tags.append(tag1)
+        if tag2:
+            tags.append(tag2)
+        
+        # Get all feedback for the agent using indexer (which handles multi-chain)
+        # Use searchFeedback with a large limit to get all feedback
+        all_feedback = self.searchFeedback(
+            agentId=agentId,
+            clientAddresses=clientAddresses,
+            tags=tags if tags else None,
+            include_revoked=False,
+            first=1000,  # Large limit to get all feedback
+            skip=0
+        )
+        
+        # Calculate summary statistics
+        count = len(all_feedback)
+        scores = [fb.score for fb in all_feedback if fb.score is not None]
+        average_score = sum(scores) / len(scores) if scores else 0.0
+        
+        # If no grouping requested, return simple summary
+        if not groupBy:
+            return {
+                "agentId": agentId,
+                "count": count,
+                "averageScore": average_score,
+                "filters": {
+                    "clientAddresses": clientAddresses,
+                    "tag1": tag1,
+                    "tag2": tag2
+                }
+            }
+        
+        # Group feedback by requested dimensions
+        grouped_data = self._groupFeedback(all_feedback, groupBy)
+        
+        return {
+            "agentId": agentId,
+            "totalCount": count,
+            "totalAverageScore": average_score,
+            "groupedData": grouped_data,
+            "filters": {
+                "clientAddresses": clientAddresses,
+                "tag1": tag1,
+                "tag2": tag2
+            },
+            "groupBy": groupBy
+        }
+    
     def _groupFeedback(self, feedbackList: List[Feedback], groupBy: List[str]) -> Dict[str, Any]:
         """Group feedback by specified dimensions."""
         grouped = {}