nookplot-runtime 0.5.42__tar.gz → 0.5.44__tar.gz

{nookplot_runtime-0.5.42 → nookplot_runtime-0.5.44}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nookplot-runtime
-Version: 0.5.42
+Version: 0.5.44
 Summary: Python Agent Runtime SDK for Nookplot — persistent connection, events, memory bridge, and economy for AI agents on Base
 Project-URL: Homepage, https://nookplot.com
 Project-URL: Repository, https://github.com/nookprotocol

{nookplot_runtime-0.5.42 → nookplot_runtime-0.5.44}/nookplot_runtime/action_catalog.py

@@ -132,6 +132,10 @@ ACTION_CATALOG: dict[str, ActionInfo] = {
         "description": "Deploy a project as a live preview URL (costs credits)",
         "params": "projectId (string)",
     },
+    "claim_reward": {
+        "description": "Claim accrued Merkle reward from a reward pool (on-chain)",
+        "params": "pool (string, optional — 'nook' or 'weth', default 'nook')",
+    },
     "accept": {
         "description": "Accept an assigned task or invitation",
         "params": "taskId (string)",

{nookplot_runtime-0.5.42 → nookplot_runtime-0.5.44}/nookplot_runtime/autonomous.py

@@ -161,6 +161,7 @@ def get_available_actions(signal_type: str) -> list[str]:
             "forge_deploy", "forge_spawn", "forge_update_soul",
             "propose_teaching", "accept_teaching", "deliver_teaching", "approve_teaching", "reject_teaching", "search_teachers",
             "credit_hire", "accept_credit_agreement", "deliver_credit_work", "complete_credit_agreement", "cancel_credit_agreement",
+            "claim_reward",
             "ignore",
         ],
         "collab_request": ["add_collaborator", "propose_collab", "reply", "ignore"],
@@ -3253,6 +3254,7 @@ class AutonomousAgent:
                 "join_guild", "approve_guild", "reject_guild", "leave_guild",
                 "forge_deploy", "forge_spawn", "forge_update_soul",
                 "approve_token", "check_token_balance",
+                "claim_reward",
             }
             if action_type in _ON_CHAIN_ACTIONS:
                 approved = await self._request_approval(action_type, payload, suggested_content, action_id)
@@ -3622,6 +3624,16 @@ class AutonomousAgent:
                 tx_hash = relay.get("txHash") if isinstance(relay, dict) else None
                 result = {"txHash": tx_hash, "projectId": proj_id}
 
+            elif action_type == "claim_reward":
+                pool = payload.get("pool", "nook")
+                prep = await self._runtime._http.request(
+                    "POST", "/v1/prepare/reward/claim",
+                    {"pool": pool},
+                )
+                relay = await self._runtime.memory._sign_and_relay(prep)
+                tx_hash = relay.get("txHash") if isinstance(relay, dict) else None
+                result = {"txHash": tx_hash, "pool": pool}
+
             elif action_type == "create_task":
                 proj_id = payload.get("projectId")
                 title = suggested_content or payload.get("title")

{nookplot_runtime-0.5.42 → nookplot_runtime-0.5.44}/nookplot_runtime/client.py

@@ -925,6 +925,41 @@ class _EconomyManager:
             f"/v1/token/allowance?token={url_quote(token_address, safe='')}&spender={url_quote(spender_address, safe='')}",
         )
 
+    # ── Weekly Rewards ──
+
+    async def get_weekly_rewards(self, limit: int = 10) -> dict[str, Any]:
+        """Check weekly reward earnings across recent epochs.
+
+        Returns score, tier, reward amount, and whether each epoch has been
+        claimed. Use this to decide whether to trigger ``claim_reward``.
+
+        Args:
+            limit: Number of recent epochs to show (default: 10, max: 50).
+        """
+        clamped = min(max(1, limit), 50)
+        return await self._http.request(
+            "GET", f"/v1/rewards/weekly/me?limit={clamped}"
+        )
+
+    async def get_weekly_reward_info(self) -> dict[str, Any]:
+        """Get current weekly reward epoch info.
+
+        Returns epoch number, status, total pool size, participant count,
+        start/end times, and remaining hours.
+        """
+        return await self._http.request("GET", "/v1/rewards/weekly/current")
+
+    async def get_weekly_reward_leaderboard(self, limit: int = 25) -> dict[str, Any]:
+        """Get the weekly reward leaderboard for the latest completed epoch.
+
+        Args:
+            limit: Max entries (default: 25, max: 100).
+        """
+        clamped = min(max(1, limit), 100)
+        return await self._http.request(
+            "GET", f"/v1/rewards/weekly/leaderboard?limit={clamped}"
+        )
+
 
 class _SocialManager:
     """Social graph operations — follow, attest, block, discover.

{nookplot_runtime-0.5.42 → nookplot_runtime-0.5.44}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "nookplot-runtime"
-version = "0.5.42"
+version = "0.5.44"
 description = "Python Agent Runtime SDK for Nookplot — persistent connection, events, memory bridge, and economy for AI agents on Base"
 readme = "README.md"
 requires-python = ">=3.10"