agent0-sdk 0.2.2__tar.gz → 0.5__tar.gz

agent0_sdk-0.5/MANIFEST.in

@@ -0,0 +1,10 @@
+exclude .env
+global-exclude *.env
+global-exclude *.env.*
+
+# local artifacts
+prune venv
+exclude agent_registration_*.json
+
+# don't ship tests in sdist by default
+prune tests

{agent0_sdk-0.2.2 → agent0_sdk-0.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent0-sdk
-Version: 0.2.2
+Version: 0.5
 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,8 +150,17 @@ 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/natural_language_generation/summarization", validate_oasf=True)
+agent.addDomain("finance_and_business/investment_services", validate_oasf=True)
+agent.addDomain("technology/data_science/data_science", validate_oasf=True)
+
 # Configure wallet and trust
-agent.setAgentWallet("0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb", chainId=11155111)
+# Note: agentWallet is an on-chain verified attribute. setAgentWallet() is on-chain only.
+# EOAs: the NEW wallet must sign an EIP-712 message. If you pass new_wallet_signer, the SDK will
+# build + sign the typed data automatically.
+# If the current SDK signer address matches the new wallet, it can auto-sign without new_wallet_signer.
 agent.setTrust(reputation=True, cryptoEconomic=True)
 
 # Add metadata and set status
@@ -161,6 +171,16 @@ agent.setActive(True)
 agent.registerIPFS()
 print(f"Agent registered: {agent.agentId}")  # e.g., "11155111:123"
 print(f"Agent URI: {agent.agentURI}")  # e.g., "ipfs://Qm..."
+
+# (Optional) Change the agent wallet after registration
+# - On mint/registration, `agentWallet` defaults to the current owner address.
+# - Call this only if you want a DIFFERENT wallet (or after a transfer, since the wallet resets to zero).
+# - Transaction is sent by the SDK signer (agent owner), but the signature must be produced by the NEW wallet.
+agent.setAgentWallet(
+    "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
+    chainId=11155111,
+    new_wallet_signer=os.getenv("NEW_WALLET_PRIVATE_KEY"),
+)
 ```
 
 ### 3. Load and Edit Agent
@@ -206,7 +226,8 @@ agent_summary = sdk.getAgent("11155111:123")
 feedback_file = sdk.prepareFeedback(
     agentId="11155111:123",
     score=85,  # 0-100 (mandatory)
-    tags=["data_analyst", "finance"],  # Optional
+    tags=["data_analyst", "finance"],  # Optional: tags are now strings (not bytes32)
+    endpoint="https://example.com/endpoint",  # Optional: endpoint URI associated with feedback
     capability="tools",  # Optional: MCP capability
     name="code_generation",  # Optional: MCP tool name
     skill="python"  # Optional: A2A skill
@@ -263,6 +284,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/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
@@ -274,7 +347,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.2 → agent0_sdk-0.5}/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,8 +80,17 @@ 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/natural_language_generation/summarization", validate_oasf=True)
+agent.addDomain("finance_and_business/investment_services", validate_oasf=True)
+agent.addDomain("technology/data_science/data_science", validate_oasf=True)
+
 # Configure wallet and trust
-agent.setAgentWallet("0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb", chainId=11155111)
+# Note: agentWallet is an on-chain verified attribute. setAgentWallet() is on-chain only.
+# EOAs: the NEW wallet must sign an EIP-712 message. If you pass new_wallet_signer, the SDK will
+# build + sign the typed data automatically.
+# If the current SDK signer address matches the new wallet, it can auto-sign without new_wallet_signer.
 agent.setTrust(reputation=True, cryptoEconomic=True)
 
 # Add metadata and set status
@@ -91,6 +101,16 @@ agent.setActive(True)
 agent.registerIPFS()
 print(f"Agent registered: {agent.agentId}")  # e.g., "11155111:123"
 print(f"Agent URI: {agent.agentURI}")  # e.g., "ipfs://Qm..."
+
+# (Optional) Change the agent wallet after registration
+# - On mint/registration, `agentWallet` defaults to the current owner address.
+# - Call this only if you want a DIFFERENT wallet (or after a transfer, since the wallet resets to zero).
+# - Transaction is sent by the SDK signer (agent owner), but the signature must be produced by the NEW wallet.
+agent.setAgentWallet(
+    "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
+    chainId=11155111,
+    new_wallet_signer=os.getenv("NEW_WALLET_PRIVATE_KEY"),
+)
 ```
 
 ### 3. Load and Edit Agent
@@ -136,7 +156,8 @@ agent_summary = sdk.getAgent("11155111:123")
 feedback_file = sdk.prepareFeedback(
     agentId="11155111:123",
     score=85,  # 0-100 (mandatory)
-    tags=["data_analyst", "finance"],  # Optional
+    tags=["data_analyst", "finance"],  # Optional: tags are now strings (not bytes32)
+    endpoint="https://example.com/endpoint",  # Optional: endpoint URI associated with feedback
     capability="tools",  # Optional: MCP capability
     name="code_generation",  # Optional: MCP tool name
     skill="python"  # Optional: A2A skill
@@ -193,6 +214,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/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
@@ -204,7 +277,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.2 → agent0_sdk-0.5}/agent0_sdk/__init__.py

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