agent0-sdk 1.5.0b1__tar.gz → 1.5.1b1__tar.gz

{agent0_sdk-1.5.0b1/agent0_sdk.egg-info → agent0_sdk-1.5.1b1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent0-sdk
-Version: 1.5.0b1
+Version: 1.5.1b1
 Summary: Python SDK for agent portability, discovery and trust based on ERC-8004
 Author-email: Agent0 Team <team@ag0.xyz>
 License: MIT License
@@ -104,10 +104,10 @@ Agent0 SDK enables you to:
 pip install agent0-sdk
 ```
 
-To install the **1.5.0 pre-release** explicitly:
+To install the **1.5.1 pre-release** explicitly:
 
 ```bash
-pip install --pre agent0-sdk==1.5.0b1
+pip install --pre agent0-sdk==1.5.1b1
 ```
 
 ### Install from Source
@@ -212,10 +212,10 @@ results = sdk.searchAgents(
         "x402support": True,
         "feedback": {"minValue": 80, "tag": "enterprise", "includeRevoked": False},
     },
-    options={"pageSize": 20, "sort": ["updatedAt:desc"]},
+    options={"sort": ["updatedAt:desc"]},
 )
 
-for agent in results['items']:
+for agent in results:
     print(f"{agent.name}: {agent.description}")
     print(f"  Tools: {agent.mcpTools}")
     print(f"  Skills: {agent.a2aSkills}")
@@ -365,6 +365,151 @@ The SDK includes complete OASF v0.8.0 taxonomy files:
 
 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).
 
+## Unified Search Reference (Exhaustive)
+
+The unified search API is:
+
+```python
+results = sdk.searchAgents(filters: dict | SearchFilters | None = None, options: dict | SearchOptions | None = None)
+# results: list[AgentSummary]
+```
+
+### `FeedbackFilters` (used as `filters["feedback"]`)
+
+```python
+@dataclass
+class FeedbackFilters:
+    hasFeedback: Optional[bool] = None
+    hasNoFeedback: Optional[bool] = None
+    includeRevoked: Optional[bool] = None
+    minValue: Optional[float] = None
+    maxValue: Optional[float] = None
+    minCount: Optional[int] = None
+    maxCount: Optional[int] = None
+    fromReviewers: Optional[List[Address]] = None
+    endpoint: Optional[str] = None          # substring match
+    hasResponse: Optional[bool] = None
+    tag1: Optional[str] = None
+    tag2: Optional[str] = None
+    tag: Optional[str] = None               # matches tag1 OR tag2
+```
+
+| Field | Semantics |
+| --- | --- |
+| `hasFeedback` / `hasNoFeedback` | Filter by whether the agent has any feedback |
+| `includeRevoked` | Include revoked feedback entries in the pool used for filtering |
+| `minValue` / `maxValue` | Threshold on **average value** over feedback matching the other feedback constraints (inclusive) |
+| `minCount` / `maxCount` | Threshold on **count** over feedback matching the other feedback constraints (inclusive) |
+| `fromReviewers` | Only consider feedback from these reviewer wallets |
+| `endpoint` | Only consider feedback whose `endpoint` contains this substring |
+| `hasResponse` | Only consider feedback that has at least one response (if supported) |
+| `tag1` / `tag2` | Only consider feedback matching tag1/tag2 |
+| `tag` | Shorthand: match either tag1 OR tag2 |
+
+### `SearchFilters`
+
+```python
+DateLike = Union[datetime, str, int]
+
+@dataclass
+class SearchFilters:
+    chains: Optional[Union[List[ChainId], Literal["all"]]] = None
+    agentIds: Optional[List[AgentId]] = None
+
+    name: Optional[str] = None
+    description: Optional[str] = None
+
+    owners: Optional[List[Address]] = None
+    operators: Optional[List[Address]] = None
+
+    hasRegistrationFile: Optional[bool] = None
+    hasWeb: Optional[bool] = None
+    hasMCP: Optional[bool] = None
+    hasA2A: Optional[bool] = None
+    hasOASF: Optional[bool] = None
+    hasEndpoints: Optional[bool] = None
+
+    webContains: Optional[str] = None
+    mcpContains: Optional[str] = None
+    a2aContains: Optional[str] = None
+    ensContains: Optional[str] = None
+    didContains: Optional[str] = None
+
+    walletAddress: Optional[Address] = None
+
+    supportedTrust: Optional[List[str]] = None
+    a2aSkills: Optional[List[str]] = None
+    mcpTools: Optional[List[str]] = None
+    mcpPrompts: Optional[List[str]] = None
+    mcpResources: Optional[List[str]] = None
+    oasfSkills: Optional[List[str]] = None
+    oasfDomains: Optional[List[str]] = None
+
+    active: Optional[bool] = None
+    x402support: Optional[bool] = None
+
+    registeredAtFrom: Optional[DateLike] = None
+    registeredAtTo: Optional[DateLike] = None
+    updatedAtFrom: Optional[DateLike] = None
+    updatedAtTo: Optional[DateLike] = None
+
+    hasMetadataKey: Optional[str] = None
+    metadataValue: Optional[Dict[str, str]] = None  # { key, value }
+
+    keyword: Optional[str] = None
+    feedback: Optional[FeedbackFilters] = None
+```
+
+### `SearchOptions`
+
+```python
+@dataclass
+class SearchOptions:
+    sort: Optional[List[str]] = None
+    semanticMinScore: Optional[float] = None
+    semanticTopK: Optional[int] = None
+```
+
+### `AgentSummary` (returned items)
+
+```python
+@dataclass
+class AgentSummary:
+    chainId: ChainId
+    agentId: AgentId
+    name: str
+    image: Optional[URI]
+    description: str
+    owners: List[Address]
+    operators: List[Address]
+    # Endpoint strings (present when advertised; not booleans)
+    mcp: Optional[str] = None
+    a2a: Optional[str] = None
+    web: Optional[str] = None
+    email: Optional[str] = None
+    ens: Optional[str] = None
+    did: Optional[str] = None
+    walletAddress: Optional[Address] = None
+    supportedTrusts: List[str] = field(default_factory=list)
+    a2aSkills: List[str] = field(default_factory=list)
+    mcpTools: List[str] = field(default_factory=list)
+    mcpPrompts: List[str] = field(default_factory=list)
+    mcpResources: List[str] = field(default_factory=list)
+    oasfSkills: List[str] = field(default_factory=list)
+    oasfDomains: List[str] = field(default_factory=list)
+    active: bool = False
+    x402support: bool = False
+    createdAt: Optional[int] = None
+    updatedAt: Optional[int] = None
+    lastActivity: Optional[int] = None
+    agentURI: Optional[str] = None
+    agentURIType: Optional[str] = None
+    feedbackCount: Optional[int] = None
+    averageValue: Optional[float] = None
+    semanticScore: Optional[float] = None
+    extras: Dict[str, Any] = field(default_factory=dict)
+```
+
 ## Use Cases
 
 - **Building agent marketplaces** - Create platforms where developers can discover, evaluate, and integrate agents based on their capabilities and reputation
@@ -374,10 +519,9 @@ Browse these files to find appropriate skill and domain slugs. For more informat
 
 ## 🚀 Coming Soon
 
-- More chains (currently Ethereum Sepolia + Ethereum Mainnet)
+- More chains (currently Ethereum Mainnet + Ethereum Sepolia + Polygon Mainnet)
 - Support for validations
 - Enhanced x402 payments
-- Semantic/Vectorial search
 - Advanced reputation aggregation
 - Import/Export to centralized catalogues
 

{agent0_sdk-1.5.0b1 → agent0_sdk-1.5.1b1}/README.md

@@ -34,10 +34,10 @@ Agent0 SDK enables you to:
 pip install agent0-sdk
 ```
 
-To install the **1.5.0 pre-release** explicitly:
+To install the **1.5.1 pre-release** explicitly:
 
 ```bash
-pip install --pre agent0-sdk==1.5.0b1
+pip install --pre agent0-sdk==1.5.1b1
 ```
 
 ### Install from Source
@@ -142,10 +142,10 @@ results = sdk.searchAgents(
         "x402support": True,
         "feedback": {"minValue": 80, "tag": "enterprise", "includeRevoked": False},
     },
-    options={"pageSize": 20, "sort": ["updatedAt:desc"]},
+    options={"sort": ["updatedAt:desc"]},
 )
 
-for agent in results['items']:
+for agent in results:
     print(f"{agent.name}: {agent.description}")
     print(f"  Tools: {agent.mcpTools}")
     print(f"  Skills: {agent.a2aSkills}")
@@ -295,6 +295,151 @@ The SDK includes complete OASF v0.8.0 taxonomy files:
 
 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).
 
+## Unified Search Reference (Exhaustive)
+
+The unified search API is:
+
+```python
+results = sdk.searchAgents(filters: dict | SearchFilters | None = None, options: dict | SearchOptions | None = None)
+# results: list[AgentSummary]
+```
+
+### `FeedbackFilters` (used as `filters["feedback"]`)
+
+```python
+@dataclass
+class FeedbackFilters:
+    hasFeedback: Optional[bool] = None
+    hasNoFeedback: Optional[bool] = None
+    includeRevoked: Optional[bool] = None
+    minValue: Optional[float] = None
+    maxValue: Optional[float] = None
+    minCount: Optional[int] = None
+    maxCount: Optional[int] = None
+    fromReviewers: Optional[List[Address]] = None
+    endpoint: Optional[str] = None          # substring match
+    hasResponse: Optional[bool] = None
+    tag1: Optional[str] = None
+    tag2: Optional[str] = None
+    tag: Optional[str] = None               # matches tag1 OR tag2
+```
+
+| Field | Semantics |
+| --- | --- |
+| `hasFeedback` / `hasNoFeedback` | Filter by whether the agent has any feedback |
+| `includeRevoked` | Include revoked feedback entries in the pool used for filtering |
+| `minValue` / `maxValue` | Threshold on **average value** over feedback matching the other feedback constraints (inclusive) |
+| `minCount` / `maxCount` | Threshold on **count** over feedback matching the other feedback constraints (inclusive) |
+| `fromReviewers` | Only consider feedback from these reviewer wallets |
+| `endpoint` | Only consider feedback whose `endpoint` contains this substring |
+| `hasResponse` | Only consider feedback that has at least one response (if supported) |
+| `tag1` / `tag2` | Only consider feedback matching tag1/tag2 |
+| `tag` | Shorthand: match either tag1 OR tag2 |
+
+### `SearchFilters`
+
+```python
+DateLike = Union[datetime, str, int]
+
+@dataclass
+class SearchFilters:
+    chains: Optional[Union[List[ChainId], Literal["all"]]] = None
+    agentIds: Optional[List[AgentId]] = None
+
+    name: Optional[str] = None
+    description: Optional[str] = None
+
+    owners: Optional[List[Address]] = None
+    operators: Optional[List[Address]] = None
+
+    hasRegistrationFile: Optional[bool] = None
+    hasWeb: Optional[bool] = None
+    hasMCP: Optional[bool] = None
+    hasA2A: Optional[bool] = None
+    hasOASF: Optional[bool] = None
+    hasEndpoints: Optional[bool] = None
+
+    webContains: Optional[str] = None
+    mcpContains: Optional[str] = None
+    a2aContains: Optional[str] = None
+    ensContains: Optional[str] = None
+    didContains: Optional[str] = None
+
+    walletAddress: Optional[Address] = None
+
+    supportedTrust: Optional[List[str]] = None
+    a2aSkills: Optional[List[str]] = None
+    mcpTools: Optional[List[str]] = None
+    mcpPrompts: Optional[List[str]] = None
+    mcpResources: Optional[List[str]] = None
+    oasfSkills: Optional[List[str]] = None
+    oasfDomains: Optional[List[str]] = None
+
+    active: Optional[bool] = None
+    x402support: Optional[bool] = None
+
+    registeredAtFrom: Optional[DateLike] = None
+    registeredAtTo: Optional[DateLike] = None
+    updatedAtFrom: Optional[DateLike] = None
+    updatedAtTo: Optional[DateLike] = None
+
+    hasMetadataKey: Optional[str] = None
+    metadataValue: Optional[Dict[str, str]] = None  # { key, value }
+
+    keyword: Optional[str] = None
+    feedback: Optional[FeedbackFilters] = None
+```
+
+### `SearchOptions`
+
+```python
+@dataclass
+class SearchOptions:
+    sort: Optional[List[str]] = None
+    semanticMinScore: Optional[float] = None
+    semanticTopK: Optional[int] = None
+```
+
+### `AgentSummary` (returned items)
+
+```python
+@dataclass
+class AgentSummary:
+    chainId: ChainId
+    agentId: AgentId
+    name: str
+    image: Optional[URI]
+    description: str
+    owners: List[Address]
+    operators: List[Address]
+    # Endpoint strings (present when advertised; not booleans)
+    mcp: Optional[str] = None
+    a2a: Optional[str] = None
+    web: Optional[str] = None
+    email: Optional[str] = None
+    ens: Optional[str] = None
+    did: Optional[str] = None
+    walletAddress: Optional[Address] = None
+    supportedTrusts: List[str] = field(default_factory=list)
+    a2aSkills: List[str] = field(default_factory=list)
+    mcpTools: List[str] = field(default_factory=list)
+    mcpPrompts: List[str] = field(default_factory=list)
+    mcpResources: List[str] = field(default_factory=list)
+    oasfSkills: List[str] = field(default_factory=list)
+    oasfDomains: List[str] = field(default_factory=list)
+    active: bool = False
+    x402support: bool = False
+    createdAt: Optional[int] = None
+    updatedAt: Optional[int] = None
+    lastActivity: Optional[int] = None
+    agentURI: Optional[str] = None
+    agentURIType: Optional[str] = None
+    feedbackCount: Optional[int] = None
+    averageValue: Optional[float] = None
+    semanticScore: Optional[float] = None
+    extras: Dict[str, Any] = field(default_factory=dict)
+```
+
 ## Use Cases
 
 - **Building agent marketplaces** - Create platforms where developers can discover, evaluate, and integrate agents based on their capabilities and reputation
@@ -304,10 +449,9 @@ Browse these files to find appropriate skill and domain slugs. For more informat
 
 ## 🚀 Coming Soon
 
-- More chains (currently Ethereum Sepolia + Ethereum Mainnet)
+- More chains (currently Ethereum Mainnet + Ethereum Sepolia + Polygon Mainnet)
 - Support for validations
 - Enhanced x402 payments
-- Semantic/Vectorial search
 - Advanced reputation aggregation
 - Import/Export to centralized catalogues
 

{agent0_sdk-1.5.0b1 → agent0_sdk-1.5.1b1}/agent0_sdk/__init__.py

@@ -35,7 +35,7 @@ except ImportError:
     TransactionMined = None
     _sdk_available = False
 
-__version__ = "1.5.0b1"
+__version__ = "1.5.1b1"
 __all__ = [
     "SDK",
     "Agent",

{agent0_sdk-1.5.0b1 → agent0_sdk-1.5.1b1}/agent0_sdk/core/feedback_manager.py

@@ -422,8 +422,6 @@ class FeedbackManager:
         minValue: Optional[float] = None,
         maxValue: Optional[float] = None,
         include_revoked: bool = False,
-        first: int = 100,
-        skip: int = 0,
         agents: Optional[List[AgentId]] = None,
     ) -> List[Feedback]:
         """Search feedback.
@@ -451,8 +449,6 @@ class FeedbackManager:
                 minValue,
                 maxValue,
                 include_revoked,
-                first,
-                skip,
                 agents=agents,
             )
         
@@ -469,8 +465,6 @@ class FeedbackManager:
                 minValue,
                 maxValue,
                 include_revoked,
-                first,
-                skip,
                 agents=agents,
             )
         
@@ -558,8 +552,6 @@ class FeedbackManager:
         minValue: Optional[float],
         maxValue: Optional[float],
         include_revoked: bool,
-        first: int,
-        skip: int,
         agents: Optional[List[AgentId]] = None,
     ) -> List[Feedback]:
         """Search feedback using subgraph."""
@@ -583,79 +575,84 @@ class FeedbackManager:
             includeRevoked=include_revoked
         )
         
-        # Query subgraph
-        feedbacks_data = self.subgraph_client.search_feedback(
-            params=params,
-            first=first,
-            skip=skip,
-            order_by="createdAt",
-            order_direction="desc"
-        )
-        
-        # Map to Feedback objects
         feedbacks = []
-        for fb_data in feedbacks_data:
-            feedback_file = fb_data.get('feedbackFile') or {}
-            if not isinstance(feedback_file, dict):
-                feedback_file = {}
-            
-            # Map responses
-            responses_data = fb_data.get('responses', [])
-            answers = []
-            for resp in responses_data:
-                answers.append({
-                    'responder': resp.get('responder'),
-                    'responseUri': resp.get('responseUri'),
-                    'responseHash': resp.get('responseHash'),
-                    'createdAt': resp.get('createdAt')
-                })
-            
-            # Map tags: rely on whatever the subgraph returns (may be legacy bytes/hash-like values)
-            tags_list: List[str] = []
-            tag1 = fb_data.get('tag1') or feedback_file.get('tag1')
-            tag2 = fb_data.get('tag2') or feedback_file.get('tag2')
-            if isinstance(tag1, str) and tag1:
+        batch = 1000
+        skip = 0
+        while True:
+            feedbacks_data = self.subgraph_client.search_feedback(
+                params=params,
+                first=batch,
+                skip=skip,
+                order_by="createdAt",
+                order_direction="desc",
+            )
+
+            for fb_data in feedbacks_data:
+                feedback_file = fb_data.get('feedbackFile') or {}
+                if not isinstance(feedback_file, dict):
+                    feedback_file = {}
+
+                # Map responses
+                responses_data = fb_data.get('responses', [])
+                answers = []
+                for resp in responses_data:
+                    answers.append({
+                        'responder': resp.get('responder'),
+                        'responseUri': resp.get('responseUri'),
+                        'responseHash': resp.get('responseHash'),
+                        'createdAt': resp.get('createdAt')
+                    })
+
+                # Map tags: rely on whatever the subgraph returns (may be legacy bytes/hash-like values)
+                tags_list: List[str] = []
+                tag1 = fb_data.get('tag1') or feedback_file.get('tag1')
+                tag2 = fb_data.get('tag2') or feedback_file.get('tag2')
+                if isinstance(tag1, str) and tag1:
                     tags_list.append(tag1)
-            if isinstance(tag2, str) and tag2:
+                if isinstance(tag2, str) and tag2:
                     tags_list.append(tag2)
-            
-            # Parse agentId from feedback ID
-            feedback_id = fb_data['id']
-            parts = feedback_id.split(':')
-            if len(parts) >= 2:
-                agent_id_str = f"{parts[0]}:{parts[1]}"
-                client_addr = parts[2] if len(parts) > 2 else ""
-                feedback_idx = int(parts[3]) if len(parts) > 3 else 1
-            else:
-                agent_id_str = feedback_id
-                client_addr = ""
-                feedback_idx = 1
-            
-            feedback = Feedback(
-                id=Feedback.create_id(agent_id_str, client_addr, feedback_idx),
-                agentId=agent_id_str,
-                reviewer=client_addr,
-                value=float(fb_data.get("value")) if fb_data.get("value") is not None else None,
-                tags=tags_list,
-                text=feedback_file.get('text'),
-                capability=feedback_file.get('capability'),
-                context=feedback_file.get('context'),
-                proofOfPayment={
-                    'fromAddress': feedback_file.get('proofOfPaymentFromAddress'),
-                    'toAddress': feedback_file.get('proofOfPaymentToAddress'),
-                    'chainId': feedback_file.get('proofOfPaymentChainId'),
-                    'txHash': feedback_file.get('proofOfPaymentTxHash'),
-                } if feedback_file.get('proofOfPaymentFromAddress') else None,
-                fileURI=fb_data.get('feedbackURI') or fb_data.get('feedbackUri'),  # Handle both old and new field names
-                endpoint=fb_data.get('endpoint'),
-                createdAt=fb_data.get('createdAt', int(time.time())),
-                answers=answers,
-                isRevoked=fb_data.get('isRevoked', False),
-                name=feedback_file.get('name'),
-                skill=feedback_file.get('skill'),
-                task=feedback_file.get('task'),
-            )
-            feedbacks.append(feedback)
+
+                # Parse agentId from feedback ID
+                feedback_id = fb_data['id']
+                parts = feedback_id.split(':')
+                if len(parts) >= 2:
+                    agent_id_str = f"{parts[0]}:{parts[1]}"
+                    client_addr = parts[2] if len(parts) > 2 else ""
+                    feedback_idx = int(parts[3]) if len(parts) > 3 else 1
+                else:
+                    agent_id_str = feedback_id
+                    client_addr = ""
+                    feedback_idx = 1
+
+                feedback = Feedback(
+                    id=Feedback.create_id(agent_id_str, client_addr, feedback_idx),
+                    agentId=agent_id_str,
+                    reviewer=client_addr,
+                    value=float(fb_data.get("value")) if fb_data.get("value") is not None else None,
+                    tags=tags_list,
+                    text=feedback_file.get('text'),
+                    capability=feedback_file.get('capability'),
+                    context=feedback_file.get('context'),
+                    proofOfPayment={
+                        'fromAddress': feedback_file.get('proofOfPaymentFromAddress'),
+                        'toAddress': feedback_file.get('proofOfPaymentToAddress'),
+                        'chainId': feedback_file.get('proofOfPaymentChainId'),
+                        'txHash': feedback_file.get('proofOfPaymentTxHash'),
+                    } if feedback_file.get('proofOfPaymentFromAddress') else None,
+                    fileURI=fb_data.get('feedbackURI') or fb_data.get('feedbackUri'),  # Handle both old and new field names
+                    endpoint=fb_data.get('endpoint'),
+                    createdAt=fb_data.get('createdAt', int(time.time())),
+                    answers=answers,
+                    isRevoked=fb_data.get('isRevoked', False),
+                    name=feedback_file.get('name'),
+                    skill=feedback_file.get('skill'),
+                    task=feedback_file.get('task'),
+                )
+                feedbacks.append(feedback)
+
+            if len(feedbacks_data) < batch:
+                break
+            skip += batch
         
         return feedbacks