agent0-sdk 0.2.1__py3-none-any.whl → 0.2.2__py3-none-any.whl

agent0_sdk/__init__.py

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

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/core/indexer.py

@@ -459,9 +459,25 @@ class AgentIndexer:
             reg_file_where["did"] = params.did
         if params.walletAddress is not None:
             reg_file_where["agentWallet"] = params.walletAddress
-        
+
         if reg_file_where:
             where_clause["registrationFile_"] = reg_file_where
+
+        # Owner filtering
+        if params.owners is not None and len(params.owners) > 0:
+            # Normalize addresses to lowercase for case-insensitive matching
+            normalized_owners = [owner.lower() for owner in params.owners]
+            if len(normalized_owners) == 1:
+                where_clause["owner"] = normalized_owners[0]
+            else:
+                where_clause["owner_in"] = normalized_owners
+
+        # Operator filtering 
+        if params.operators is not None and len(params.operators) > 0:
+            # Normalize addresses to lowercase for case-insensitive matching
+            normalized_operators = [op.lower() for op in params.operators]
+            # For operators (array field), use contains to check if any operator matches
+            where_clause["operators_contains"] = normalized_operators
         
         # Calculate pagination
         skip = 0

agent0_sdk/core/ipfs_client.py

@@ -80,7 +80,7 @@ class IPFSClient:
         except (subprocess.CalledProcessError, FileNotFoundError):
             raise RuntimeError(
                 "filecoin-pin CLI not found. "
-                "Install it from: https://github.com/filecoin-shipyard/filecoin-pin"
+                "Install it from: https://github.com/filecoin-project/filecoin-pin?tab=readme-ov-file#cli"
             )
 
     def _pin_to_filecoin(self, file_path: str) -> str:

{agent0_sdk-0.2.1.dist-info → agent0_sdk-0.2.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent0-sdk
-Version: 0.2.1
+Version: 0.2.2
 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"

{agent0_sdk-0.2.1.dist-info → agent0_sdk-0.2.2.dist-info}/RECORD

@@ -1,15 +1,15 @@
-agent0_sdk/__init__.py,sha256=-OXCylWFuiIbSCs9CHqmWoc8mVDRUhIlHyATUJkRBwo,919
+agent0_sdk/__init__.py,sha256=SOJFcN81--KPhBSpHV0T85Q7Z1qZxxjLedZDCSbfkm0,919
 agent0_sdk/core/agent.py,sha256=RQND8F3Hmmpnt-PqCXBP7T8KfrjTXo0_X2nZoMJh01w,33343
 agent0_sdk/core/contracts.py,sha256=mER1pSae4-fiGBwaVTi7oqJ_QYaDnrtyIF7g6dkdE-0,19889
-agent0_sdk/core/endpoint_crawler.py,sha256=JFLW4-SoQlpyXsUDWeOb6h-u1ilEKNVQF0r6LI-3k68,11026
+agent0_sdk/core/endpoint_crawler.py,sha256=QBkFc3tBSQqHj6PtSTZ5D3_HVB00KJZJdxE3uYpI9po,13611
 agent0_sdk/core/feedback_manager.py,sha256=wkV-P5wgDwOLwhaf22qOl-3S2F_PNI7oCHBBZMAxugI,36017
-agent0_sdk/core/indexer.py,sha256=XIW0WN9PlcDn-2p_W1y9OviYH6fCGHCSrdtGEaP02xo,40328
-agent0_sdk/core/ipfs_client.py,sha256=YHZRsgHlxl3bpkaHORunBtVMNEPWKfn_xx92Yi6l1Fk,13907
+agent0_sdk/core/indexer.py,sha256=bl5TqTSytt_qQyGqUsqZvrnXFlmQEuOgm6uKEE-u-BQ,41161
+agent0_sdk/core/ipfs_client.py,sha256=fml1ai1BdBkgb95xAkf-ft8QsahV1HL30hBYRz7rQwI,13929
 agent0_sdk/core/models.py,sha256=bQARVmKETiVL5uJpHxXGN2wY2GFrdzxhPHqjzL8TBlQ,12373
 agent0_sdk/core/sdk.py,sha256=stOurnsSoedUFKaHKhrjaM1sghBzjighizV6AaZD7-U,31560
 agent0_sdk/core/subgraph_client.py,sha256=XXFVFAoHcgEfqxc2w2OksSp8vtbKMtsNIuNbNcNQOzE,27280
 agent0_sdk/core/web3_client.py,sha256=859ntu5dAmNlcJ3YM1w_VV2gI3mpCC9QEr-GN1236zU,6850
-agent0_sdk-0.2.1.dist-info/licenses/LICENSE,sha256=rhZZbZm_Ovz4Oa9LNQ-ms8a1tA36wWh90ZkC0OR7WMw,1072
+agent0_sdk-0.2.2.dist-info/licenses/LICENSE,sha256=rhZZbZm_Ovz4Oa9LNQ-ms8a1tA36wWh90ZkC0OR7WMw,1072
 tests/__init__.py,sha256=60ffheccPhuMCtwiiKP1X-CJJXKpxJ_Ywa0aXGHR9bY,23
 tests/config.py,sha256=1uePvkLBNubOQsvYkQSno0m007PMD1VACgm33fCYY6s,1429
 tests/conftest.py,sha256=P-HCtVVYwSvscuaJqhrgZcv39XXNnr932ekEamzIqis,589
@@ -19,9 +19,9 @@ tests/test_real_public_servers.py,sha256=pCo4aLSCG9qv4D6T7jbyVmP1gt3r1jWxdes6z5X
 tests/test_registration.py,sha256=pYanDPLAFETIfabBUvO34ZDmyD0Rbcv8vecSfgSrQ70,9542
 tests/test_registrationIpfs.py,sha256=9O3IBiN2CVMKzB19bqb-jN-nhqsN22kQINMpe9THqiI,8400
 tests/test_sdk.py,sha256=dALLFm_A6aXx0ec-CNOLGQoadaSPZ08EEeCS6Tgnm0M,9362
-tests/test_search.py,sha256=YC5Zd0c99JhFoy7POwrUkb36I1Q3S9hJPIQrIZIJCwI,11850
+tests/test_search.py,sha256=SiUio8H-M6Za8OXD_h9tUZdln0ayzkPJ3doTrkHv-Fs,18382
 tests/test_transfer.py,sha256=zRBllpoMs6NhagAmaZWmD4ckbYjSvsSUerBK4oS-HlA,9258
-agent0_sdk-0.2.1.dist-info/METADATA,sha256=hoLm4OlzGmLq62SnlDAm09-izRz2YsadSaODGa2bOxs,11424
-agent0_sdk-0.2.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-agent0_sdk-0.2.1.dist-info/top_level.txt,sha256=rgGBfOJlLi1zInQ85jBL2MpDu_ZJNbPjIGz-3Vn5rZs,17
-agent0_sdk-0.2.1.dist-info/RECORD,,
+agent0_sdk-0.2.2.dist-info/METADATA,sha256=mw1WxxAWC29tQ-FhDD_c7NJWPwyEGSYJ_w6atYM8CtY,11404
+agent0_sdk-0.2.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+agent0_sdk-0.2.2.dist-info/top_level.txt,sha256=rgGBfOJlLi1zInQ85jBL2MpDu_ZJNbPjIGz-3Vn5rZs,17
+agent0_sdk-0.2.2.dist-info/RECORD,,

tests/test_search.py

@@ -15,6 +15,13 @@ Flow:
 10. Search agents by reputation with capability filtering
 11. Advanced: Find top-rated agents with specific skills
 12. Advanced: Find agents with multiple requirements
+13. Pagination test
+14. Sort by activity test
+15. Search agents by single owner address
+16. Search agents by multiple owner addresses
+17. Search agents by operator addresses
+18. Combined search: owner + active status
+19. Combined search: owner + name filter
 """
 
 import logging
@@ -261,7 +268,144 @@ def main():
                 print(f"   {i}. ID {agent_id}: {agent['name']}")
     except Exception as e:
         print(f"❌ Failed activity sort: {e}")
-    
+
+    print(f"\n📍 Step 15: Search Agents by Single Owner Address")
+    print("-" * 60)
+    try:
+        # First, get an agent to extract its owner address for testing
+        test_agent = sdk.getAgent(AGENT_ID)
+        if hasattr(test_agent, 'owner') and test_agent.owner:
+            owner_address = test_agent.owner
+            print(f"   Testing with owner address: {owner_address}")
+
+            results = sdk.searchAgents(owners=[owner_address])
+            agents = results.get('items', [])
+            print(f"✅ Found {len(agents)} agent(s) owned by {owner_address[:10]}...{owner_address[-8:]}")
+
+            for i, agent in enumerate(agents[:3], 1):
+                agent_id = agent.get('agentId', agent.get('id', 'N/A'))
+                agent_owner = agent.get('owner', 'N/A')
+                print(f"   {i}. {agent['name']} (ID: {agent_id})")
+                print(f"      Owner: {agent_owner[:10]}...{agent_owner[-8:] if len(agent_owner) > 18 else agent_owner}")
+        else:
+            print("⚠️  Test agent doesn't have owner information")
+    except Exception as e:
+        print(f"❌ Failed to search by single owner: {e}")
+
+    print(f"\n📍 Step 16: Search Agents by Multiple Owner Addresses")
+    print("-" * 60)
+    try:
+        # Get multiple agents to collect different owner addresses
+        results = sdk.searchAgents(page_size=5)
+        agents = results.get('items', [])
+        owner_addresses = []
+
+        for agent in agents:
+            if agent.get('owner') and agent['owner'] not in owner_addresses:
+                owner_addresses.append(agent['owner'])
+                if len(owner_addresses) >= 2:
+                    break
+
+        if len(owner_addresses) >= 2:
+            print(f"   Testing with {len(owner_addresses)} owner addresses")
+            results = sdk.searchAgents(owners=owner_addresses)
+            agents = results.get('items', [])
+            print(f"✅ Found {len(agents)} agent(s) owned by multiple addresses")
+
+            for i, agent in enumerate(agents[:5], 1):
+                agent_id = agent.get('agentId', agent.get('id', 'N/A'))
+                agent_owner = agent.get('owner', 'N/A')
+                print(f"   {i}. {agent['name']} (Owner: {agent_owner[:10]}...{agent_owner[-8:] if len(agent_owner) > 18 else agent_owner})")
+        else:
+            print("⚠️  Not enough different owners found for multi-owner test")
+    except Exception as e:
+        print(f"❌ Failed to search by multiple owners: {e}")
+
+    print(f"\n📍 Step 17: Search Agents by Operator Addresses")
+    print("-" * 60)
+    try:
+        # First check if any agents have operators defined
+        results = sdk.searchAgents(page_size=10)
+        agents = results.get('items', [])
+        test_operators = []
+
+        for agent in agents:
+            if agent.get('operators') and len(agent['operators']) > 0:
+                test_operators = agent['operators'][:1]  # Use first operator
+                print(f"   Testing with operator: {test_operators[0][:10]}...{test_operators[0][-8:]}")
+                break
+
+        if test_operators:
+            results = sdk.searchAgents(operators=test_operators)
+            found_agents = results.get('items', [])
+            print(f"✅ Found {len(found_agents)} agent(s) with specified operator")
+
+            for i, agent in enumerate(found_agents[:3], 1):
+                agent_id = agent.get('agentId', agent.get('id', 'N/A'))
+                agent_operators = agent.get('operators', [])
+                print(f"   {i}. {agent['name']} (ID: {agent_id})")
+                if agent_operators:
+                    print(f"      Operators: {len(agent_operators)} total")
+        else:
+            print("⚠️  No agents with operators found for testing")
+    except Exception as e:
+        print(f"❌ Failed to search by operators: {e}")
+
+    print(f"\n📍 Step 18: Combined Search - Owner + Active Status")
+    print("-" * 60)
+    try:
+        # Get an owner address from an active agent
+        results = sdk.searchAgents(active=True, page_size=5)
+        agents = results.get('items', [])
+
+        if agents and agents[0].get('owner'):
+            test_owner = agents[0]['owner']
+            print(f"   Testing owner {test_owner[:10]}...{test_owner[-8:]} + active=True")
+
+            results = sdk.searchAgents(owners=[test_owner], active=True)
+            found_agents = results.get('items', [])
+            print(f"✅ Found {len(found_agents)} active agent(s) owned by specified address")
+
+            for i, agent in enumerate(found_agents[:3], 1):
+                agent_id = agent.get('agentId', agent.get('id', 'N/A'))
+                print(f"   {i}. {agent['name']} (ID: {agent_id})")
+                print(f"      Active: {agent.get('active', False)}, Owner: {agent.get('owner', 'N/A')[:10]}...")
+        else:
+            print("⚠️  No active agents with owner information found")
+    except Exception as e:
+        print(f"❌ Failed combined owner + active search: {e}")
+
+    print(f"\n📍 Step 19: Combined Search - Owner + Name Filter")
+    print("-" * 60)
+    try:
+        # Get agents and find one with both name and owner
+        results = sdk.searchAgents(page_size=10)
+        agents = results.get('items', [])
+
+        test_agent = None
+        for agent in agents:
+            if agent.get('owner') and agent.get('name'):
+                test_agent = agent
+                break
+
+        if test_agent:
+            test_owner = test_agent['owner']
+            # Use partial name for search
+            name_part = test_agent['name'][:4] if len(test_agent['name']) > 4 else test_agent['name']
+            print(f"   Testing owner filter + name contains '{name_part}'")
+
+            results = sdk.searchAgents(owners=[test_owner], name=name_part)
+            found_agents = results.get('items', [])
+            print(f"✅ Found {len(found_agents)} agent(s) matching both criteria")
+
+            for i, agent in enumerate(found_agents[:3], 1):
+                agent_id = agent.get('agentId', agent.get('id', 'N/A'))
+                print(f"   {i}. {agent['name']} (ID: {agent_id})")
+        else:
+            print("⚠️  No suitable test agent found")
+    except Exception as e:
+        print(f"❌ Failed combined owner + name search: {e}")
+
     print("\n" + "=" * 60)
     print("✅ Search Tests Completed!")
     print("=" * 60)