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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent0-sdk
-Version: 0.3rc1
+Version: 0.31
 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
@@ -76,10 +76,11 @@ Agent0 is the SDK for agentic economies. It enables agents to register, advertis
 
 ## What Does Agent0 SDK Do?
 
-Agent0 SDK v0.2 enables you to:
+Agent0 SDK v0.31 enables you to:
 
 - **Create and manage agent identities** - Register your AI agent on-chain with a unique identity, configure presentation fields (name, description, image), set wallet addresses, and manage trust models with x402 support
 - **Advertise agent capabilities** - Publish MCP and A2A endpoints, with automated extraction of MCP tools and A2A skills from endpoints
+- **OASF taxonomies** - Advertise standardized skills and domains using the Open Agentic Schema Framework (OASF) taxonomies for better discovery and interoperability
 - **Enable permissionless discovery** - Make your agent discoverable by other agents and platforms using rich search by attributes, capabilities, skills, tools, tasks, and x402 support
 - **Build reputation** - Give and receive feedback, retrieve feedback history, and search agents by reputation with cryptographic authentication
 - **Cross-chain registration** - One-line registration with IPFS nodes, Pinata, Filecoin, or HTTP URIs
@@ -87,7 +88,7 @@ Agent0 SDK v0.2 enables you to:
 
 ## ⚠️ Alpha Release
 
-Agent0 SDK v0.2 is in **alpha** with bugs and is not production ready. We're actively testing and improving it.
+Agent0 SDK v0.31 is in **alpha** with bugs and is not production ready. We're actively testing and improving it.
 
 **Bug reports & feedback:** GitHub: [Report issues](https://github.com/agent0lab/agent0-py/issues) | Telegram: [@marcoderossi](https://t.me/marcoderossi) | Email: marco.derossi@consensys.net
 
@@ -149,6 +150,12 @@ agent.setMCP("https://mcp.example.com/")  # Extracts tools, prompts, resources
 agent.setA2A("https://a2a.example.com/agent-card.json")  # Extracts skills
 agent.setENS("myagent.eth")
 
+# Add OASF skills and domains (standardized taxonomies)
+agent.addSkill("data_engineering/data_transformation_pipeline", validate_oasf=True)
+agent.addSkill("natural_language_processing/summarization", validate_oasf=True)
+agent.addDomain("finance_and_business/investment_services", validate_oasf=True)
+agent.addDomain("technology/data_science", validate_oasf=True)
+
 # Configure wallet and trust
 agent.setAgentWallet("0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb", chainId=11155111)
 agent.setTrust(reputation=True, cryptoEconomic=True)
@@ -263,6 +270,58 @@ sdk = SDK(chainId=11155111, rpcUrl="...", signer=private_key)
 agent.register("https://example.com/agent-registration.json")
 ```
 
+## OASF Taxonomies
+
+The SDK includes support for the **Open Agentic Schema Framework (OASF)** taxonomies, enabling agents to advertise standardized skills and domains. This improves discoverability and interoperability across agent platforms.
+
+### Adding Skills and Domains
+
+```python
+# Add OASF skills (with optional validation)
+agent.addSkill("advanced_reasoning_planning/strategic_planning", validate_oasf=True)
+agent.addSkill("data_engineering/data_transformation_pipeline", validate_oasf=True)
+
+# Add OASF domains (with optional validation)
+agent.addDomain("finance_and_business/investment_services", validate_oasf=True)
+agent.addDomain("technology/data_science/data_visualization", validate_oasf=True)
+
+# Remove skills/domains
+agent.removeSkill("old_skill")
+agent.removeDomain("old_domain")
+```
+
+### OASF in Registration Files
+
+OASF skills and domains appear in your agent's registration file:
+
+```json
+{
+  "endpoints": [
+    {
+      "name": "OASF",
+      "endpoint": "https://github.com/agntcy/oasf/",
+      "version": "v0.8.0",
+      "skills": [
+        "advanced_reasoning_planning/strategic_planning",
+        "data_engineering/data_transformation_pipeline"
+      ],
+      "domains": [
+        "finance_and_business/investment_services",
+        "technology/data_science"
+      ]
+    }
+  ]
+}
+```
+
+### Taxonomy Files
+
+The SDK includes complete OASF v0.8.0 taxonomy files:
+- **Skills**: `agent0_sdk/taxonomies/all_skills.json` (136 skills)
+- **Domains**: `agent0_sdk/taxonomies/all_domains.json` (204 domains)
+
+Browse these files to find appropriate skill and domain slugs. For more information, see the [OASF specification](https://github.com/agntcy/oasf) and [Release Notes v0.31](RELEASE_NOTES_0.31.md).
+
 ## Use Cases
 
 - **Building agent marketplaces** - Create platforms where developers can discover, evaluate, and integrate agents based on their capabilities and reputation

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

@@ -6,10 +6,11 @@ Agent0 is the SDK for agentic economies. It enables agents to register, advertis
 
 ## What Does Agent0 SDK Do?
 
-Agent0 SDK v0.2 enables you to:
+Agent0 SDK v0.31 enables you to:
 
 - **Create and manage agent identities** - Register your AI agent on-chain with a unique identity, configure presentation fields (name, description, image), set wallet addresses, and manage trust models with x402 support
 - **Advertise agent capabilities** - Publish MCP and A2A endpoints, with automated extraction of MCP tools and A2A skills from endpoints
+- **OASF taxonomies** - Advertise standardized skills and domains using the Open Agentic Schema Framework (OASF) taxonomies for better discovery and interoperability
 - **Enable permissionless discovery** - Make your agent discoverable by other agents and platforms using rich search by attributes, capabilities, skills, tools, tasks, and x402 support
 - **Build reputation** - Give and receive feedback, retrieve feedback history, and search agents by reputation with cryptographic authentication
 - **Cross-chain registration** - One-line registration with IPFS nodes, Pinata, Filecoin, or HTTP URIs
@@ -17,7 +18,7 @@ Agent0 SDK v0.2 enables you to:
 
 ## ⚠️ Alpha Release
 
-Agent0 SDK v0.2 is in **alpha** with bugs and is not production ready. We're actively testing and improving it.
+Agent0 SDK v0.31 is in **alpha** with bugs and is not production ready. We're actively testing and improving it.
 
 **Bug reports & feedback:** GitHub: [Report issues](https://github.com/agent0lab/agent0-py/issues) | Telegram: [@marcoderossi](https://t.me/marcoderossi) | Email: marco.derossi@consensys.net
 
@@ -79,6 +80,12 @@ agent.setMCP("https://mcp.example.com/")  # Extracts tools, prompts, resources
 agent.setA2A("https://a2a.example.com/agent-card.json")  # Extracts skills
 agent.setENS("myagent.eth")
 
+# Add OASF skills and domains (standardized taxonomies)
+agent.addSkill("data_engineering/data_transformation_pipeline", validate_oasf=True)
+agent.addSkill("natural_language_processing/summarization", validate_oasf=True)
+agent.addDomain("finance_and_business/investment_services", validate_oasf=True)
+agent.addDomain("technology/data_science", validate_oasf=True)
+
 # Configure wallet and trust
 agent.setAgentWallet("0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb", chainId=11155111)
 agent.setTrust(reputation=True, cryptoEconomic=True)
@@ -193,6 +200,58 @@ sdk = SDK(chainId=11155111, rpcUrl="...", signer=private_key)
 agent.register("https://example.com/agent-registration.json")
 ```
 
+## OASF Taxonomies
+
+The SDK includes support for the **Open Agentic Schema Framework (OASF)** taxonomies, enabling agents to advertise standardized skills and domains. This improves discoverability and interoperability across agent platforms.
+
+### Adding Skills and Domains
+
+```python
+# Add OASF skills (with optional validation)
+agent.addSkill("advanced_reasoning_planning/strategic_planning", validate_oasf=True)
+agent.addSkill("data_engineering/data_transformation_pipeline", validate_oasf=True)
+
+# Add OASF domains (with optional validation)
+agent.addDomain("finance_and_business/investment_services", validate_oasf=True)
+agent.addDomain("technology/data_science/data_visualization", validate_oasf=True)
+
+# Remove skills/domains
+agent.removeSkill("old_skill")
+agent.removeDomain("old_domain")
+```
+
+### OASF in Registration Files
+
+OASF skills and domains appear in your agent's registration file:
+
+```json
+{
+  "endpoints": [
+    {
+      "name": "OASF",
+      "endpoint": "https://github.com/agntcy/oasf/",
+      "version": "v0.8.0",
+      "skills": [
+        "advanced_reasoning_planning/strategic_planning",
+        "data_engineering/data_transformation_pipeline"
+      ],
+      "domains": [
+        "finance_and_business/investment_services",
+        "technology/data_science"
+      ]
+    }
+  ]
+}
+```
+
+### Taxonomy Files
+
+The SDK includes complete OASF v0.8.0 taxonomy files:
+- **Skills**: `agent0_sdk/taxonomies/all_skills.json` (136 skills)
+- **Domains**: `agent0_sdk/taxonomies/all_domains.json` (204 domains)
+
+Browse these files to find appropriate skill and domain slugs. For more information, see the [OASF specification](https://github.com/agntcy/oasf) and [Release Notes v0.31](RELEASE_NOTES_0.31.md).
+
 ## Use Cases
 
 - **Building agent marketplaces** - Create platforms where developers can discover, evaluate, and integrate agents based on their capabilities and reputation

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

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

{agent0_sdk-0.3rc1 → agent0_sdk-0.31}/agent0_sdk/core/agent.py

@@ -16,6 +16,7 @@ from .models import (
 )
 from .web3_client import Web3Client
 from .endpoint_crawler import EndpointCrawler
+from .oasf_validator import validate_skill, validate_domain
 
 if TYPE_CHECKING:
     from .sdk import SDK
@@ -316,6 +317,137 @@ class Agent:
         """Remove all endpoints."""
         return self.removeEndpoint()
 
+    # OASF endpoint management
+    def _get_or_create_oasf_endpoint(self) -> Endpoint:
+        """Get existing OASF endpoint or create a new one with default values."""
+        # Find existing OASF endpoint
+        for ep in self.registration_file.endpoints:
+            if ep.type == EndpointType.OASF:
+                return ep
+        
+        # Create new OASF endpoint with default values
+        oasf_endpoint = Endpoint(
+            type=EndpointType.OASF,
+            value="https://github.com/agntcy/oasf/",
+            meta={"version": "v0.8.0", "skills": [], "domains": []}
+        )
+        self.registration_file.endpoints.append(oasf_endpoint)
+        return oasf_endpoint
+
+    def addSkill(self, slug: str, validate_oasf: bool = False) -> 'Agent':
+        """
+        Add a skill to the OASF endpoint.
+        
+        Args:
+            slug: The skill slug to add (e.g., "natural_language_processing/summarization")
+            validate_oasf: If True, validate the slug against the OASF taxonomy (default: False)
+        
+        Returns:
+            self for method chaining
+        
+        Raises:
+            ValueError: If validate_oasf=True and the slug is not valid
+        """
+        if validate_oasf:
+            if not validate_skill(slug):
+                raise ValueError(
+                    f"Invalid OASF skill slug: {slug}. "
+                    "Use validate_oasf=False to skip validation."
+                )
+        
+        oasf_endpoint = self._get_or_create_oasf_endpoint()
+        
+        # Initialize skills array if missing
+        if "skills" not in oasf_endpoint.meta:
+            oasf_endpoint.meta["skills"] = []
+        
+        # Add slug if not already present (avoid duplicates)
+        skills = oasf_endpoint.meta["skills"]
+        if slug not in skills:
+            skills.append(slug)
+        
+        self.registration_file.updatedAt = int(time.time())
+        return self
+
+    def removeSkill(self, slug: str) -> 'Agent':
+        """
+        Remove a skill from the OASF endpoint.
+        
+        Args:
+            slug: The skill slug to remove
+        
+        Returns:
+            self for method chaining
+        """
+        # Find OASF endpoint
+        for ep in self.registration_file.endpoints:
+            if ep.type == EndpointType.OASF:
+                if "skills" in ep.meta and isinstance(ep.meta["skills"], list):
+                    skills = ep.meta["skills"]
+                    if slug in skills:
+                        skills.remove(slug)
+                self.registration_file.updatedAt = int(time.time())
+                break
+        
+        return self
+
+    def addDomain(self, slug: str, validate_oasf: bool = False) -> 'Agent':
+        """
+        Add a domain to the OASF endpoint.
+        
+        Args:
+            slug: The domain slug to add (e.g., "finance_and_business/investment_services")
+            validate_oasf: If True, validate the slug against the OASF taxonomy (default: False)
+        
+        Returns:
+            self for method chaining
+        
+        Raises:
+            ValueError: If validate_oasf=True and the slug is not valid
+        """
+        if validate_oasf:
+            if not validate_domain(slug):
+                raise ValueError(
+                    f"Invalid OASF domain slug: {slug}. "
+                    "Use validate_oasf=False to skip validation."
+                )
+        
+        oasf_endpoint = self._get_or_create_oasf_endpoint()
+        
+        # Initialize domains array if missing
+        if "domains" not in oasf_endpoint.meta:
+            oasf_endpoint.meta["domains"] = []
+        
+        # Add slug if not already present (avoid duplicates)
+        domains = oasf_endpoint.meta["domains"]
+        if slug not in domains:
+            domains.append(slug)
+        
+        self.registration_file.updatedAt = int(time.time())
+        return self
+
+    def removeDomain(self, slug: str) -> 'Agent':
+        """
+        Remove a domain from the OASF endpoint.
+        
+        Args:
+            slug: The domain slug to remove
+        
+        Returns:
+            self for method chaining
+        """
+        # Find OASF endpoint
+        for ep in self.registration_file.endpoints:
+            if ep.type == EndpointType.OASF:
+                if "domains" in ep.meta and isinstance(ep.meta["domains"], list):
+                    domains = ep.meta["domains"]
+                    if slug in domains:
+                        domains.remove(slug)
+                self.registration_file.updatedAt = int(time.time())
+                break
+        
+        return self
+
     # Trust models
     def setTrust(
         self,

{agent0_sdk-0.3rc1 → agent0_sdk-0.31}/agent0_sdk/core/models.py

@@ -28,6 +28,7 @@ class EndpointType(Enum):
     ENS = "ENS"
     DID = "DID"
     WALLET = "wallet"
+    OASF = "OASF"
 
 
 class TrustModel(Enum):

agent0_sdk-0.31/agent0_sdk/core/oasf_validator.py

@@ -0,0 +1,98 @@
+"""
+OASF taxonomy validation utilities.
+"""
+
+import json
+import os
+from pathlib import Path
+from typing import Optional
+
+# Cache for loaded taxonomy data
+_skills_cache: Optional[dict] = None
+_domains_cache: Optional[dict] = None
+
+
+def _get_taxonomy_path(filename: str) -> Path:
+    """Get the path to a taxonomy file."""
+    # Get the directory where this file is located
+    current_dir = Path(__file__).parent
+    # Go up one level to agent0_sdk, then into taxonomies
+    taxonomy_dir = current_dir.parent / "taxonomies"
+    return taxonomy_dir / filename
+
+
+def _load_skills() -> dict:
+    """Load skills taxonomy file with caching."""
+    global _skills_cache
+    if _skills_cache is None:
+        skills_path = _get_taxonomy_path("all_skills.json")
+        try:
+            with open(skills_path, "r", encoding="utf-8") as f:
+                _skills_cache = json.load(f)
+        except FileNotFoundError:
+            raise FileNotFoundError(
+                f"Skills taxonomy file not found: {skills_path}"
+            )
+        except json.JSONDecodeError as e:
+            raise ValueError(
+                f"Invalid JSON in skills taxonomy file: {e}"
+            )
+    return _skills_cache
+
+
+def _load_domains() -> dict:
+    """Load domains taxonomy file with caching."""
+    global _domains_cache
+    if _domains_cache is None:
+        domains_path = _get_taxonomy_path("all_domains.json")
+        try:
+            with open(domains_path, "r", encoding="utf-8") as f:
+                _domains_cache = json.load(f)
+        except FileNotFoundError:
+            raise FileNotFoundError(
+                f"Domains taxonomy file not found: {domains_path}"
+            )
+        except json.JSONDecodeError as e:
+            raise ValueError(
+                f"Invalid JSON in domains taxonomy file: {e}"
+            )
+    return _domains_cache
+
+
+def validate_skill(slug: str) -> bool:
+    """
+    Validate if a skill slug exists in the OASF taxonomy.
+    
+    Args:
+        slug: The skill slug to validate (e.g., "natural_language_processing/summarization")
+    
+    Returns:
+        True if the skill exists in the taxonomy, False otherwise
+    
+    Raises:
+        FileNotFoundError: If the taxonomy file cannot be found
+        ValueError: If the taxonomy file is invalid JSON
+    """
+    skills_data = _load_skills()
+    skills = skills_data.get("skills", {})
+    return slug in skills
+
+
+def validate_domain(slug: str) -> bool:
+    """
+    Validate if a domain slug exists in the OASF taxonomy.
+    
+    Args:
+        slug: The domain slug to validate (e.g., "finance_and_business/investment_services")
+    
+    Returns:
+        True if the domain exists in the taxonomy, False otherwise
+    
+    Raises:
+        FileNotFoundError: If the taxonomy file cannot be found
+        ValueError: If the taxonomy file is invalid JSON
+    """
+    domains_data = _load_domains()
+    domains = domains_data.get("domains", {})
+    return slug in domains
+