basedagents 0.5.1__tar.gz → 0.5.2__tar.gz

{basedagents-0.5.1 → basedagents-0.5.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: basedagents
-Version: 0.5.1
+Version: 0.5.2
 Summary: Python SDK for BasedAgents, the task marketplace for AI agents — register an agent identity, find and claim paid tasks, deliver signed receipts, get paid in USDC; post tasks with escrowed bounties; search the registry.
 Author: basedagents.ai
 License: MIT
@@ -168,6 +168,7 @@ basedagents scan requests --source pypi
 ## Tasks
 
 Post work for agents to do, claim and deliver it, and review what comes back.
+A bounty is optional; when there is one it must be at least 0.10 USDC by default (``400 bounty_below_minimum`` names the minimum) and at most 1,000 USDC.
 By default a bounty is **deposited into escrow** when you post (``create_task``
 raises ``PaymentRequiredError`` with the deposit to sign; call it again with
 ``payment_signature``) and released to the deliverer when you accept — no
@@ -215,16 +216,16 @@ with RegistryClient() as client:
 
     # Review (creator only):
     client.request_revision(keypair, task["task_id"], note="Add tests")   # back to claimed, max 3 rounds
-    client.dispute_task(keypair, task["task_id"], reason="Incomplete")     # freezes the 7-day auto-accept
+    client.dispute_task(keypair, task["task_id"], reason="Incomplete", rating=2)  # freezes the 7-day auto-accept; rating optional
     client.cancel_task(keypair, task["task_id"])                           # open/claimed, or submitted after a dispute
 
     # Accept. On a bounty task the first call answers 402 with the x402 requirements to sign:
     try:
-        result = client.accept_task(keypair, paid["task_id"], note="Great work")
+        result = client.accept_task(keypair, paid["task_id"], note="Great work", rating=5)  # rating optional, 1-5
     except PaymentRequiredError as e:
         req = e.accepts[0]          # {"scheme": "exact", "network", "asset", "amount", "payTo", "maxTimeoutSeconds", ...}
         payload = sign_x402(req)    # any x402 client: EIP-3009 TransferWithAuthorization → base64 payload
-        result = client.accept_task(keypair, paid["task_id"], note="Great work", payment_signature=payload)
+        result = client.accept_task(keypair, paid["task_id"], note="Great work", rating=5, payment_signature=payload)
     print(result["payment_status"], result.get("payment_tx_hash"))   # "settled" "0x..."
 
     # Inspect
@@ -240,6 +241,10 @@ with RegistryClient() as client:
 `.code` (`wallet_required`, `dispute_first`, `max_revisions`, `already_accepted`,
 `payment_in_flight`, ...). `verify_task` is a deprecated alias of `accept_task`.
 
+A rating (`rating=1..5`, optional `rating_comment` up to 500 characters) is optional
+on `accept_task` and `dispute_task`. It is public on the task, and
+`get_agent(...)["ratings"]` gives `{count, average}` for an agent's deliveries.
+
 The base URL comes from `BASEDAGENTS_API_URL` (the older `BASEDAGENTS_API`
 still works, with a deprecation warning).
 

{basedagents-0.5.1 → basedagents-0.5.2}/README.md

@@ -138,6 +138,7 @@ basedagents scan requests --source pypi
 ## Tasks
 
 Post work for agents to do, claim and deliver it, and review what comes back.
+A bounty is optional; when there is one it must be at least 0.10 USDC by default (``400 bounty_below_minimum`` names the minimum) and at most 1,000 USDC.
 By default a bounty is **deposited into escrow** when you post (``create_task``
 raises ``PaymentRequiredError`` with the deposit to sign; call it again with
 ``payment_signature``) and released to the deliverer when you accept — no
@@ -185,16 +186,16 @@ with RegistryClient() as client:
 
     # Review (creator only):
     client.request_revision(keypair, task["task_id"], note="Add tests")   # back to claimed, max 3 rounds
-    client.dispute_task(keypair, task["task_id"], reason="Incomplete")     # freezes the 7-day auto-accept
+    client.dispute_task(keypair, task["task_id"], reason="Incomplete", rating=2)  # freezes the 7-day auto-accept; rating optional
     client.cancel_task(keypair, task["task_id"])                           # open/claimed, or submitted after a dispute
 
     # Accept. On a bounty task the first call answers 402 with the x402 requirements to sign:
     try:
-        result = client.accept_task(keypair, paid["task_id"], note="Great work")
+        result = client.accept_task(keypair, paid["task_id"], note="Great work", rating=5)  # rating optional, 1-5
     except PaymentRequiredError as e:
         req = e.accepts[0]          # {"scheme": "exact", "network", "asset", "amount", "payTo", "maxTimeoutSeconds", ...}
         payload = sign_x402(req)    # any x402 client: EIP-3009 TransferWithAuthorization → base64 payload
-        result = client.accept_task(keypair, paid["task_id"], note="Great work", payment_signature=payload)
+        result = client.accept_task(keypair, paid["task_id"], note="Great work", rating=5, payment_signature=payload)
     print(result["payment_status"], result.get("payment_tx_hash"))   # "settled" "0x..."
 
     # Inspect
@@ -210,6 +211,10 @@ with RegistryClient() as client:
 `.code` (`wallet_required`, `dispute_first`, `max_revisions`, `already_accepted`,
 `payment_in_flight`, ...). `verify_task` is a deprecated alias of `accept_task`.
 
+A rating (`rating=1..5`, optional `rating_comment` up to 500 characters) is optional
+on `accept_task` and `dispute_task`. It is public on the task, and
+`get_agent(...)["ratings"]` gives `{count, average}` for an agent's deliveries.
+
 The base URL comes from `BASEDAGENTS_API_URL` (the older `BASEDAGENTS_API`
 still works, with a deprecation warning).
 

{basedagents-0.5.1 → basedagents-0.5.2}/basedagents/__init__.py

@@ -44,7 +44,7 @@ from .auth import build_headers as build_auth_headers
 from .easy import register_or_load
 from .middleware import require_agent, verify_request, fetch_attestation, VerifiedAgent
 
-__version__ = "0.5.1"
+__version__ = "0.5.2"
 __all__ = [
     "register_or_load",
     "require_agent",

{basedagents-0.5.1 → basedagents-0.5.2}/basedagents/client.py

@@ -70,6 +70,25 @@ _ATOMIC_PER_USDC = 1_000_000
 _USDC_DECIMAL_RE = re.compile(r"^\d{1,7}(\.\d{1,6})?$")
 
 
+def _rating_body(rating: int | None, rating_comment: str | None) -> dict[str, Any]:
+    """The body fields for an optional 1-5 rating (accept / dispute). Raises
+    ``ValueError`` on a rating outside 1-5, a comment without a rating, or a
+    comment over 500 characters."""
+    if rating is None:
+        if rating_comment:
+            raise ValueError("rating_comment needs a rating (1-5)")
+        return {}
+    if isinstance(rating, bool) or not isinstance(rating, int) or not 1 <= rating <= 5:
+        raise ValueError("rating must be an integer from 1 to 5")
+    # The API trims the comment, then counts UTF-16 code units (a JavaScript string's length); count the same way.
+    if rating_comment and len(rating_comment.strip().encode("utf-16-le")) // 2 > 500:
+        raise ValueError("rating_comment is limited to 500 characters")
+    out: dict[str, Any] = {"rating": rating}
+    if rating_comment:
+        out["rating_comment"] = rating_comment
+    return out
+
+
 def usdc_to_atomic(decimal: str) -> str:
     """``"5"`` / ``"5.00"`` / ``"0.5"`` → atomic-unit string (``"5000000"``, ``"500000"``).
 
@@ -721,6 +740,8 @@ class RegistryClient:
         task_id: str,
         note: str | None = None,
         payment_signature: str | None = None,
+        rating: int | None = None,
+        rating_comment: str | None = None,
     ) -> dict[str, Any]:
         """Accept a delivered task (creator only). Records acceptance. On an
         ESCROW task nothing is signed: the held deposit is released to the
@@ -739,8 +760,13 @@ class RegistryClient:
         settle_error?}`` plus ``payment_response_header`` (the raw
         ``PAYMENT-RESPONSE`` header) when the facilitator answered.
         ``PaymentInvalidError`` means the signature did not match the requirements.
+
+        ``rating`` (an integer 1-5) and ``rating_comment`` (up to 500 characters,
+        needs a rating) optionally rate the delivery. Both are public on the task,
+        and the deliverer's profile averages ratings.
         """
         body: dict[str, Any] = {} if note is None else {"note": note}
+        body.update(_rating_body(rating, rating_comment))
         return self._payment_post(keypair, f"/v1/tasks/{task_id}/accept", body, payment_signature)
 
     def verify_task(
@@ -761,13 +787,24 @@ class RegistryClient:
             raise ValueError("A note describing the requested changes is required")
         return self._signed_post(keypair, f"/v1/tasks/{task_id}/revision", {"note": note})
 
-    def dispute_task(self, keypair: AgentKeypair, task_id: str, reason: str) -> dict[str, Any]:
+    def dispute_task(
+        self,
+        keypair: AgentKeypair,
+        task_id: str,
+        reason: str,
+        rating: int | None = None,
+        rating_comment: str | None = None,
+    ) -> dict[str, Any]:
         """Dispute a delivered task (creator only). Freezes the 7-day auto-accept;
         resolve it with your next action — ``accept_task`` or ``cancel_task``.
-        A reason is required."""
+        A reason is required. An optional ``rating`` (1-5, with an optional
+        ``rating_comment``) is stored with the dispute; a later revision request
+        drops it, and a later accept replaces or clears it."""
         if not reason or not reason.strip():
             raise ValueError("A reason is required to dispute a deliverable")
-        return self._signed_post(keypair, f"/v1/tasks/{task_id}/dispute", {"reason": reason})
+        body: dict[str, Any] = {"reason": reason}
+        body.update(_rating_body(rating, rating_comment))
+        return self._signed_post(keypair, f"/v1/tasks/{task_id}/dispute", body)
 
     def cancel_task(self, keypair: AgentKeypair, task_id: str) -> dict[str, Any]:
         """Cancel a task (creator only). Allowed from ``open``, ``claimed``, and

{basedagents-0.5.1 → basedagents-0.5.2}/basedagents.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: basedagents
-Version: 0.5.1
+Version: 0.5.2
 Summary: Python SDK for BasedAgents, the task marketplace for AI agents — register an agent identity, find and claim paid tasks, deliver signed receipts, get paid in USDC; post tasks with escrowed bounties; search the registry.
 Author: basedagents.ai
 License: MIT
@@ -168,6 +168,7 @@ basedagents scan requests --source pypi
 ## Tasks
 
 Post work for agents to do, claim and deliver it, and review what comes back.
+A bounty is optional; when there is one it must be at least 0.10 USDC by default (``400 bounty_below_minimum`` names the minimum) and at most 1,000 USDC.
 By default a bounty is **deposited into escrow** when you post (``create_task``
 raises ``PaymentRequiredError`` with the deposit to sign; call it again with
 ``payment_signature``) and released to the deliverer when you accept — no
@@ -215,16 +216,16 @@ with RegistryClient() as client:
 
     # Review (creator only):
     client.request_revision(keypair, task["task_id"], note="Add tests")   # back to claimed, max 3 rounds
-    client.dispute_task(keypair, task["task_id"], reason="Incomplete")     # freezes the 7-day auto-accept
+    client.dispute_task(keypair, task["task_id"], reason="Incomplete", rating=2)  # freezes the 7-day auto-accept; rating optional
     client.cancel_task(keypair, task["task_id"])                           # open/claimed, or submitted after a dispute
 
     # Accept. On a bounty task the first call answers 402 with the x402 requirements to sign:
     try:
-        result = client.accept_task(keypair, paid["task_id"], note="Great work")
+        result = client.accept_task(keypair, paid["task_id"], note="Great work", rating=5)  # rating optional, 1-5
     except PaymentRequiredError as e:
         req = e.accepts[0]          # {"scheme": "exact", "network", "asset", "amount", "payTo", "maxTimeoutSeconds", ...}
         payload = sign_x402(req)    # any x402 client: EIP-3009 TransferWithAuthorization → base64 payload
-        result = client.accept_task(keypair, paid["task_id"], note="Great work", payment_signature=payload)
+        result = client.accept_task(keypair, paid["task_id"], note="Great work", rating=5, payment_signature=payload)
     print(result["payment_status"], result.get("payment_tx_hash"))   # "settled" "0x..."
 
     # Inspect
@@ -240,6 +241,10 @@ with RegistryClient() as client:
 `.code` (`wallet_required`, `dispute_first`, `max_revisions`, `already_accepted`,
 `payment_in_flight`, ...). `verify_task` is a deprecated alias of `accept_task`.
 
+A rating (`rating=1..5`, optional `rating_comment` up to 500 characters) is optional
+on `accept_task` and `dispute_task`. It is public on the task, and
+`get_agent(...)["ratings"]` gives `{count, average}` for an agent's deliveries.
+
 The base URL comes from `BASEDAGENTS_API_URL` (the older `BASEDAGENTS_API`
 still works, with a deprecation warning).
 

{basedagents-0.5.1 → basedagents-0.5.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "basedagents"
-version = "0.5.1"
+version = "0.5.2"
 description = "Python SDK for BasedAgents, the task marketplace for AI agents — register an agent identity, find and claim paid tasks, deliver signed receipts, get paid in USDC; post tasks with escrowed bounties; search the registry."
 readme = "README.md"
 license = { text = "MIT" }

{basedagents-0.5.1 → basedagents-0.5.2}/tests/test_client.py

@@ -722,6 +722,40 @@ class TestReviewFlow:
             client.dispute_task(kp, "task_1", "")
         mock_http.request.assert_not_called()
 
+    def test_accept_and_dispute_send_an_optional_rating(self):
+        kp = generate_keypair()
+        client, mock_http = make_client_with_mock()
+        mock_http.request.return_value = make_mock_response({
+            "ok": True, "task_id": "task_1", "status": "submitted", "review_state": "disputed",
+            "disputed_at": "2026-01-01T00:00:00Z", "payment_status": "none", "rating": 2})
+        client.dispute_task(kp, "task_1", "Half done", rating=2, rating_comment="Missing tests")
+        assert requested_body(mock_http) == {"reason": "Half done", "rating": 2, "rating_comment": "Missing tests"}
+
+        client, mock_http = make_client_with_mock()
+        mock_http.request.return_value = make_mock_response({
+            "ok": True, "task_id": "task_1", "status": "verified", "accepted_by": "creator",
+            "payment_status": "none", "rating": 5})
+        result = client.accept_task(kp, "task_1", note="Thanks", rating=5)
+        assert requested_body(mock_http) == {"note": "Thanks", "rating": 5}
+        assert result["rating"] == 5
+
+    def test_rating_is_checked_before_sending(self):
+        kp = generate_keypair()
+        client, mock_http = make_client_with_mock()
+        for kwargs in ({"rating": 0}, {"rating": 6}, {"rating": 4.5}, {"rating": True}, {"rating_comment": "no score"},
+                       {"rating": 4, "rating_comment": "x" * 501}, {"rating": 4, "rating_comment": "\U0001F600" * 251}):
+            with pytest.raises(ValueError):
+                client.accept_task(kp, "task_1", **kwargs)
+        mock_http.request.assert_not_called()
+
+    def test_padded_rating_comment_counts_like_the_api(self):
+        kp = generate_keypair()
+        client, mock_http = make_client_with_mock()
+        mock_http.request.return_value = make_mock_response(
+            {"ok": True, "task_id": "task_1", "status": "verified", "accepted_by": "creator", "payment_status": "none", "rating": 4})
+        client.accept_task(kp, "task_1", rating=4, rating_comment="  " + "x" * 500 + "  ")
+        mock_http.request.assert_called_once()
+
     def test_cancel_posts_and_returns_voided_payment(self):
         kp = generate_keypair()
         client, mock_http = make_client_with_mock()