agent0-sdk 1.5.0b1__py3-none-any.whl → 1.5.1b1__py3-none-any.whl

agent0_sdk/core/models.py

@@ -165,11 +165,6 @@ class AgentSummary:
     description: str
     owners: List[Address]
     operators: List[Address]
-    # Endpoint strings (new unified search + Jan 2026 schema)
-    mcp: Optional[str] = None
-    a2a: Optional[str] = None
-    web: Optional[str] = None
-    email: Optional[str] = None
     ens: Optional[str]
     did: Optional[str]
     walletAddress: Optional[Address]
@@ -178,9 +173,14 @@ class AgentSummary:
     mcpTools: List[str]
     mcpPrompts: List[str]
     mcpResources: List[str]
+    active: bool
+    # Endpoint strings (new unified search + Jan 2026 schema)
+    mcp: Optional[str] = None
+    a2a: Optional[str] = None
+    web: Optional[str] = None
+    email: Optional[str] = None
     oasfSkills: List[str] = field(default_factory=list)
     oasfDomains: List[str] = field(default_factory=list)
-    active: bool
     x402support: bool = False
     createdAt: Optional[int] = None
     updatedAt: Optional[int] = None
@@ -358,8 +358,6 @@ class SearchFilters:
 @dataclass
 class SearchOptions:
     sort: Optional[List[str]] = None
-    pageSize: Optional[int] = None
-    cursor: Optional[str] = None
     semanticMinScore: Optional[float] = None
     semanticTopK: Optional[int] = None
 

agent0_sdk/core/sdk.py

@@ -463,7 +463,7 @@ class SDK:
         filters: Union[SearchFilters, Dict[str, Any], None] = None,
         options: Union[SearchOptions, Dict[str, Any], None] = None,
         **kwargs  # Accept search criteria as kwargs for better DX
-    ) -> Dict[str, Any]:
+    ) -> List[AgentSummary]:
         """Search for agents.
         
         Examples:
@@ -473,9 +473,6 @@ class SDK:
             
             # Explicit SearchParams (for complex queries or IDE autocomplete)
             sdk.searchAgents(SearchParams(name="Test", mcpTools=["code_generation"]))
-            
-            # With pagination
-            sdk.searchAgents(name="Test", page_size=10)
         """
         # Allow kwargs to populate filters for better DX.
         if kwargs and filters is None:
@@ -488,19 +485,17 @@ class SDK:
             if isinstance(filters.get("feedback"), dict):
                 filters["feedback"] = FeedbackFilters(**filters["feedback"])
             filters = SearchFilters(**filters)
-
+        
         if options is None:
             options = SearchOptions()
         elif isinstance(options, dict):
             options = SearchOptions(**options)
 
-        if options.sort is None:
-            options.sort = ["updatedAt:desc"]
-
-        if options.pageSize is None:
-            options.pageSize = 50
-
-        return self.indexer.search_agents(filters, options)
+        # Do not force a default sort here; the indexer chooses keyword-aware defaults.
+        out = self.indexer.search_agents(filters, options)
+        if isinstance(out, dict):
+            return out.get("items") or []
+        return out or []
 
     # Feedback methods are defined later in this class (single authoritative API).
     
@@ -559,8 +554,6 @@ class SDK:
         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.
@@ -602,8 +595,6 @@ class SDK:
             minValue=minValue,
             maxValue=maxValue,
             include_revoked=include_revoked,
-            first=first,
-            skip=skip,
         )
     
     def revokeFeedback(

agent0_sdk/core/semantic_search_client.py

@@ -21,7 +21,7 @@ class SemanticSearchClient:
     def __init__(
         self,
         base_url: str = "https://semantic-search.ag0.xyz",
-        timeout_seconds: float = 10.0,
+        timeout_seconds: float = 20.0,
     ):
         self.base_url = base_url.rstrip("/")
         self.timeout_seconds = timeout_seconds
@@ -30,11 +30,15 @@ class SemanticSearchClient:
         if not query or not query.strip():
             return []
 
-        body = {"query": query.strip()}
-        if min_score is not None:
-            body["minScore"] = min_score
-        if top_k is not None:
-            body["topK"] = top_k
+        # SDK defaults (applied here so developers don't need to pass them).
+        # - minScore: 0.5
+        # - topK: 5000 (API expects "limit" not "topK" in v1)
+        if min_score is None:
+            min_score = 0.5
+        if top_k is None:
+            top_k = 5000
+
+        body = {"query": query.strip(), "minScore": min_score, "limit": top_k}
 
         resp = requests.post(
             f"{self.base_url}/api/v1/search",

{agent0_sdk-1.5.0b1.dist-info → agent0_sdk-1.5.1b1.dist-info}/METADATA

@@ -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.dist-info → agent0_sdk-1.5.1b1.dist-info}/RECORD

@@ -1,22 +1,22 @@
-agent0_sdk/__init__.py,sha256=XAcKn73_sk5qlTtmT4w_LDMRvwYjPWbn1qppyWh82r4,1190
+agent0_sdk/__init__.py,sha256=l-IYzlB87rfM6Rigthoasgc80HmQ-BHHbJENZU6St6I,1190
 agent0_sdk/core/agent.py,sha256=P3AX7zm4G5qkWdTJcjOvR69cCyOovHefbRoKejj6QKY,48062
 agent0_sdk/core/contracts.py,sha256=EVxtxc5z6hI7p40Va5ibu0Pssmi6Y6UEG1_wfO7TZ_U,22942
 agent0_sdk/core/endpoint_crawler.py,sha256=QBkFc3tBSQqHj6PtSTZ5D3_HVB00KJZJdxE3uYpI9po,13611
-agent0_sdk/core/feedback_manager.py,sha256=gHCyBYK17Yc5HcxDcbhl_blXYqulYO-7oiEvoPQomms,42585
-agent0_sdk/core/indexer.py,sha256=pCVrgWXVVJJMAu_ABs-nweAK9rZ-DR2uMSA51T7KaPY,102199
+agent0_sdk/core/feedback_manager.py,sha256=rgQSxjNlEtBLN_bzQ1rnPL2kuaHCHM5vIEyw7Uitg3Q,42696
+agent0_sdk/core/indexer.py,sha256=apXiAA-kYEcRMv6s8NgiguwinPs3cKihLZ4B8jqaPAE,75122
 agent0_sdk/core/ipfs_client.py,sha256=17XXMpJgLWhcNUSkmduAZt409c8oJXlj9C_eTGVk-Io,14185
-agent0_sdk/core/models.py,sha256=ssgMPzCv7ykalF9je9KqFLD4ep_lAYU_P9E8L8fl0Lw,14451
+agent0_sdk/core/models.py,sha256=xZc93KKzsgc1cm0yymN2lFaMFv6MuaUNS9tcxT6Lktg,14383
 agent0_sdk/core/oasf_validator.py,sha256=ZOtYYzQd7cJj3eJegi7Ch5ydoapJEjaJSxMvwzKSp5o,2980
-agent0_sdk/core/sdk.py,sha256=JjBEpDvnoOSEkZcr9vPqjzaDCUcrJobY43o3oICgiRY,27632
-agent0_sdk/core/semantic_search_client.py,sha256=dMI9dT2MtgdlYE07ttPgOPV2yusdlD9C-DMHNEj7wrA,1837
+agent0_sdk/core/sdk.py,sha256=TKagv6AufrCWFmfOa79yODa6--PP4tt5G8UCXWS59N0,27484
+agent0_sdk/core/semantic_search_client.py,sha256=MrWMKmZ6qQhqKiIDiS2W5Aop4ak-YQ9VastIVlVzL0c,2013
 agent0_sdk/core/subgraph_client.py,sha256=VBHSdMKIr-DLRKu0bGQMBC_fdxI8SgNMqVLpPWYuQc0,27374
 agent0_sdk/core/transaction_handle.py,sha256=tKo6ny02m3eIeDGo0Wjikf-yUtl_8KYJy5YxFkPvyHo,1958
 agent0_sdk/core/value_encoding.py,sha256=NQUUvjTRAr5Tqj8t4HUGlfhak8VDmB8E5WMlfAqJwVk,3311
 agent0_sdk/core/web3_client.py,sha256=9w5ZgHILteCHSOisae3QluwuIsX3OD-VkoAc01koQWA,13786
 agent0_sdk/taxonomies/all_domains.json,sha256=buM8_6mpY8_AMbBIPzM-gtu14Tl30QDmhuQxxrlJU4c,74625
 agent0_sdk/taxonomies/all_skills.json,sha256=WVsutw3fqoj1jfDPru3CyWTr1kc1a5-EhBOWPfXnEi8,47483
-agent0_sdk-1.5.0b1.dist-info/licenses/LICENSE,sha256=rhZZbZm_Ovz4Oa9LNQ-ms8a1tA36wWh90ZkC0OR7WMw,1072
-agent0_sdk-1.5.0b1.dist-info/METADATA,sha256=-GtWe1NHrXnsAKDrEwM67K61yG-4Lr4hnRjkUJ_qoOU,15431
-agent0_sdk-1.5.0b1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-agent0_sdk-1.5.0b1.dist-info/top_level.txt,sha256=p4520WUKNfhU0lVWJgkrB_jdeUfvHSY3K18k4oYLNfI,11
-agent0_sdk-1.5.0b1.dist-info/RECORD,,
+agent0_sdk-1.5.1b1.dist-info/licenses/LICENSE,sha256=rhZZbZm_Ovz4Oa9LNQ-ms8a1tA36wWh90ZkC0OR7WMw,1072
+agent0_sdk-1.5.1b1.dist-info/METADATA,sha256=srsv0FCyL6LWGo3zldnLEHVH-CQAXQ7lnAqSnRoIc_k,20216
+agent0_sdk-1.5.1b1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+agent0_sdk-1.5.1b1.dist-info/top_level.txt,sha256=p4520WUKNfhU0lVWJgkrB_jdeUfvHSY3K18k4oYLNfI,11
+agent0_sdk-1.5.1b1.dist-info/RECORD,,