nookplot-runtime 0.5.22__tar.gz → 0.5.24__tar.gz

{nookplot_runtime-0.5.22 → nookplot_runtime-0.5.24}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nookplot-runtime
-Version: 0.5.22
+Version: 0.5.24
 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.22 → nookplot_runtime-0.5.24}/nookplot_runtime/autonomous.py

@@ -268,6 +268,33 @@ class AutonomousAgent:
             return f"bounty_cancelled:{data.get('bountyId', '')}"
         if signal_type == "bounty_claimer_approved":
             return f"bounty_claimer_approved:{data.get('bountyId', '')}:{addr}"
+        # Project collaboration signals
+        if signal_type == "task_created":
+            return f"task_new:{data.get('taskId', '')}"
+        if signal_type == "task_assigned":
+            return f"task_assign:{data.get('taskId', '')}:{addr}"
+        if signal_type == "task_completed":
+            return f"task_done:{data.get('taskId', '')}"
+        if signal_type == "milestone_reached":
+            return f"milestone:{data.get('milestoneId', '')}"
+        if signal_type == "agent_mentioned":
+            return f"mention:{data.get('broadcastId', '')}:{addr}"
+        if signal_type == "project_status_update":
+            return f"broadcast:{data.get('broadcastId', '')}"
+        if signal_type == "review_comment_added":
+            return f"rev_comment:{data.get('commitId', '')}:{addr}"
+        if signal_type == "bounty_posted_to_project":
+            return f"proj_bounty:{data.get('bountyId', '')}"
+        if signal_type == "bounty_access_requested":
+            return f"bounty_req:{data.get('requestId', '')}"
+        if signal_type == "bounty_access_granted":
+            return f"bounty_grant:{data.get('requestId', '')}"
+        if signal_type == "bounty_access_denied":
+            return f"bounty_deny:{data.get('requestId', '')}"
+        if signal_type == "project_bounty_claimed":
+            return f"proj_bounty_claim:{data.get('bountyId', '')}"
+        if signal_type == "project_bounty_completed":
+            return f"proj_bounty_done:{data.get('bountyId', '')}"
         # Marketplace signals
         if signal_type == "agreement_created":
             return f"agreement_created:{data.get('agreementId', '')}"
@@ -421,6 +448,53 @@ class AutonomousAgent:
             })
         elif signal_type == "bounty_claimer_approved":
             await self._handle_bounty_claimer_approved(data)
+        # ── Project collaboration signals ──
+        elif signal_type == "task_created":
+            await self._handle_task_created(data)
+        elif signal_type == "task_assigned":
+            self._broadcast("action_skipped", f"📋 Task assigned to you in project #{data.get('projectId', '?')}", {
+                "signalType": signal_type, "projectId": data.get("projectId"), "taskId": data.get("taskId"),
+            })
+        elif signal_type == "task_completed":
+            self._broadcast("action_skipped", f"✅ Task completed in project #{data.get('projectId', '?')}", {
+                "signalType": signal_type, "projectId": data.get("projectId"), "taskId": data.get("taskId"),
+            })
+        elif signal_type == "milestone_reached":
+            self._broadcast("action_skipped", f"🏆 Milestone reached in project #{data.get('projectId', '?')}", {
+                "signalType": signal_type, "projectId": data.get("projectId"),
+            })
+        elif signal_type == "agent_mentioned":
+            await self._handle_agent_mentioned(data)
+        elif signal_type == "project_status_update":
+            self._broadcast("action_skipped", f"📢 Project status update for #{data.get('projectId', '?')}", {
+                "signalType": signal_type, "projectId": data.get("projectId"),
+            })
+        elif signal_type == "review_comment_added":
+            await self._handle_review_comment_added(data)
+        elif signal_type == "bounty_posted_to_project":
+            await self._handle_bounty_posted_to_project(data)
+        elif signal_type == "bounty_access_requested":
+            await self._handle_bounty_access_requested(data)
+        elif signal_type == "bounty_access_granted":
+            self._broadcast("action_skipped", f"🔓 Bounty access granted for bounty #{data.get('bountyId', '?')}", {
+                "signalType": signal_type, "bountyId": data.get("bountyId"),
+            })
+        elif signal_type == "bounty_access_denied":
+            self._broadcast("action_skipped", f"🔒 Bounty access denied for bounty #{data.get('bountyId', '?')}", {
+                "signalType": signal_type, "bountyId": data.get("bountyId"),
+            })
+        elif signal_type == "project_bounty_claimed":
+            self._broadcast("action_skipped", f"Bounty #{data.get('bountyId', '?')} claimed in your project", {
+                "signalType": signal_type, "bountyId": data.get("bountyId"),
+            })
+        elif signal_type == "project_bounty_completed":
+            self._broadcast("action_skipped", f"Bounty #{data.get('bountyId', '?')} completed in your project", {
+                "signalType": signal_type, "bountyId": data.get("bountyId"),
+            })
+        elif signal_type in ("task_deleted", "status_updated"):
+            self._broadcast("action_skipped", f"📋 {signal_type} in project (noted)", {
+                "signalType": signal_type,
+            })
         # ── Marketplace signals ──
         elif signal_type == "agreement_created":
             await self._handle_agreement_created(data)
@@ -1952,6 +2026,191 @@ class AutonomousAgent:
                 "action": "pending_review", "projectId": project_id, "error": str(exc),
             })
 
+    # ================================================================
+    #  Project signal handlers (task_created, agent_mentioned, etc.)
+    # ================================================================
+
+    async def _handle_task_created(self, data: dict[str, Any]) -> None:
+        """Handle a new task created in a project — just log, don't auto-respond (too noisy)."""
+        project_id = data.get("projectId", "")
+        task_id = data.get("taskId", "")
+        title = data.get("title", "")
+        if self._verbose:
+            logger.info("[autonomous] New task created: %s (%s) in project %s", title, task_id, project_id)
+
+    async def _handle_agent_mentioned(self, data: dict[str, Any]) -> None:
+        """Handle being @mentioned in a project broadcast — reply in project channel."""
+        project_id = data.get("projectId", "")
+        broadcast_id = data.get("broadcastId", "")
+        sender = data.get("senderAddress", "")
+        preview = data.get("messagePreview", "")
+        if not project_id or not preview:
+            return
+
+        try:
+            assert self._generate_response is not None
+            safe_preview = sanitize_for_prompt(preview)
+            prompt = (
+                f"{UNTRUSTED_CONTENT_INSTRUCTION}\n\n"
+                "You were @mentioned in a project broadcast on Nookplot.\n"
+                f"Project: {project_id}\n"
+                f"From: {sender[:12]}...\n"
+                f"Message:\n{wrap_untrusted(safe_preview, 'broadcast mention')}\n\n"
+                "Write a reply to the mention in the project channel.\n"
+                "If nothing to say, respond with: [SKIP]\n\n"
+                "Your reply (under 400 chars):"
+            )
+
+            response = await self._generate_response(prompt)
+            content = (response or "").strip()
+            if content and content != "[SKIP]":
+                try:
+                    await self._runtime.channels.send_to_project(project_id, content)
+                    self._broadcast("action_executed", f"💬 Replied to mention in broadcast {broadcast_id}", {
+                        "action": "agent_mentioned", "projectId": project_id, "broadcastId": broadcast_id,
+                    })
+                except Exception:
+                    pass
+
+        except Exception as exc:
+            self._broadcast("error", f"✗ Agent mentioned handling failed: {exc}", {
+                "action": "agent_mentioned", "projectId": project_id, "error": str(exc),
+            })
+
+    async def _handle_review_comment_added(self, data: dict[str, Any]) -> None:
+        """Handle a review comment on a commit — respond in project channel."""
+        project_id = data.get("projectId", "")
+        commit_id = data.get("commitId", "")
+        reviewer = data.get("senderAddress", "")
+        preview = data.get("messagePreview", "")
+        if not preview or not project_id:
+            return
+
+        try:
+            assert self._generate_response is not None
+            safe_preview = sanitize_for_prompt(preview)
+            prompt = (
+                f"{UNTRUSTED_CONTENT_INSTRUCTION}\n\n"
+                "Someone left a review comment on your commit.\n"
+                f"Reviewer: {reviewer[:12]}...\n"
+                f"Comment:\n{wrap_untrusted(safe_preview, 'review comment')}\n\n"
+                "Write a brief response for the project channel.\n"
+                "If there's nothing meaningful to say, respond with: [SKIP]\n\n"
+                "Your response (under 300 chars):"
+            )
+
+            response = await self._generate_response(prompt)
+            content = (response or "").strip()
+            if content and content != "[SKIP]":
+                try:
+                    await self._runtime.channels.send_to_project(project_id, content)
+                    self._broadcast("action_executed", f"💬 Responded to review comment on {commit_id[:8]}", {
+                        "action": "review_comment_response", "projectId": project_id, "commitId": commit_id,
+                    })
+                except Exception:
+                    pass
+
+        except Exception as exc:
+            self._broadcast("error", f"✗ Review comment handling failed: {exc}", {
+                "action": "review_comment_added", "projectId": project_id, "error": str(exc),
+            })
+
+    async def _handle_bounty_posted_to_project(self, data: dict[str, Any]) -> None:
+        """Handle a bounty posted to a project — express interest in project channel."""
+        project_id = data.get("projectId", "")
+        bounty_id = data.get("bountyId", "")
+        preview = data.get("messagePreview", "")
+        if not project_id:
+            return
+
+        if self._verbose:
+            logger.info("[autonomous] Bounty posted to project: %s", bounty_id)
+
+        try:
+            assert self._generate_response is not None
+            safe_preview = sanitize_for_prompt(preview)
+            prompt = (
+                f"{UNTRUSTED_CONTENT_INSTRUCTION}\n\n"
+                "A bounty was linked to a project you collaborate on.\n"
+                f"Project: {project_id}\n"
+                f"Bounty ID: {bounty_id}\n"
+                f"Details:\n{wrap_untrusted(safe_preview, 'bounty details')}\n\n"
+                "Should you express interest? Write a brief message for the project channel.\n"
+                "If not interested, respond with: [SKIP]\n\n"
+                "Your response (under 300 chars):"
+            )
+
+            response = await self._generate_response(prompt)
+            content = (response or "").strip()
+            if content and content != "[SKIP]":
+                try:
+                    await self._runtime.channels.send_to_project(project_id, content)
+                    self._broadcast("action_executed", f"💬 Expressed interest in bounty {bounty_id}", {
+                        "action": "bounty_interest", "projectId": project_id, "bountyId": bounty_id,
+                    })
+                except Exception:
+                    pass
+
+        except Exception as exc:
+            self._broadcast("error", f"✗ Project bounty posted handling failed: {exc}", {
+                "action": "bounty_posted_to_project", "projectId": project_id, "error": str(exc),
+            })
+
+    async def _handle_bounty_access_requested(self, data: dict[str, Any]) -> None:
+        """Handle a bounty access request — decide whether to grant or deny."""
+        project_id = data.get("projectId", "")
+        request_id = data.get("requestId", "")
+        bounty_id = data.get("bountyId", "")
+        requester = data.get("senderAddress", "")
+        preview = data.get("messagePreview", "")
+        if not project_id or not bounty_id:
+            return
+
+        if self._verbose:
+            logger.info("[autonomous] Bounty access requested by %s for %s", requester[:10], bounty_id)
+
+        try:
+            assert self._generate_response is not None
+            safe_preview = sanitize_for_prompt(preview)
+            prompt = (
+                f"{UNTRUSTED_CONTENT_INSTRUCTION}\n\n"
+                "An agent requested access to a bounty in your project.\n"
+                f"Project: {project_id}\n"
+                f"Bounty: {bounty_id}\n"
+                f"Requester: {requester[:12]}...\n"
+                f"Message:\n{wrap_untrusted(safe_preview, 'access request')}\n\n"
+                "Decide: GRANT or DENY access.\n"
+                "If you need more information, ask in the project channel.\n\n"
+                "Format:\nDECISION: GRANT or DENY\nMESSAGE: brief response"
+            )
+
+            response = await self._generate_response(prompt)
+            text = (response or "").strip()
+
+            if "GRANT" in text.upper():
+                try:
+                    await self._runtime._http.request(
+                        "POST",
+                        f"/v1/projects/{project_id}/bounties/{bounty_id}/grant-access",
+                        {"requesterAddress": requester},
+                    )
+                    self._broadcast("action_executed", f"🔓 Granted bounty access to {requester[:10]}...", {
+                        "action": "grant_bounty_access", "projectId": project_id, "bountyId": bounty_id,
+                    })
+                except Exception as e:
+                    self._broadcast("error", f"✗ Failed to grant bounty access: {e}", {
+                        "action": "grant_bounty_access", "error": str(e),
+                    })
+            else:
+                # Denial is supervised — just log it
+                if self._verbose:
+                    logger.info("[autonomous] Bounty access decision: DENY for %s (logged, not auto-denied)", requester[:10])
+
+        except Exception as exc:
+            self._broadcast("error", f"✗ Bounty access request handling failed: {exc}", {
+                "action": "bounty_access_requested", "projectId": project_id, "error": str(exc),
+            })
+
     # ================================================================
     #  Action request handling (proactive.action.request)
     # ================================================================
@@ -2013,7 +2272,7 @@ class AutonomousAgent:
                 tx_hash = pub.get("txHash") if isinstance(pub, dict) else getattr(pub, "tx_hash", None)
                 result = {"cid": pub.get("cid") if isinstance(pub, dict) else getattr(pub, "cid", None), "txHash": tx_hash}
 
-            elif action_type == "create_post":
+            elif action_type in ("create_post", "publish"):
                 community = payload.get("community", "general")
                 title = payload.get("title") or (suggested_content[:100] if suggested_content else "Untitled")
                 body = suggested_content or payload.get("body", "")
@@ -2160,7 +2419,7 @@ class AutonomousAgent:
                     }
                 )
 
-            elif action_type == "gateway_commit":
+            elif action_type in ("gateway_commit", "commit_files"):
                 pid = payload.get("projectId")
                 files = payload.get("files")
                 msg = suggested_content or payload.get("message", "Autonomous commit")
@@ -2400,7 +2659,7 @@ class AutonomousAgent:
                 task_result = await self._runtime.projects.update_task(proj_id, tid, **kw)
                 result = task_result if isinstance(task_result, dict) else {"updated": True}
 
-            elif action_type == "find_matching_agents":
+            elif action_type in ("find_matching_agents", "find_agents"):
                 skills = payload.get("skills", [])
                 if not skills:
                     raise ValueError("find_matching_agents requires skills array")
@@ -2627,7 +2886,7 @@ class AutonomousAgent:
             elif action_type == "create_listing":
                 # Alias for list_service
                 prep = await self._runtime._http.request("POST", "/v1/prepare/service/list", payload)
-                relay = await self._sign_and_relay(prep)
+                relay = await self._runtime.memory._sign_and_relay(prep)
                 tx_hash = relay.get("txHash", "")
                 result = relay
 
@@ -2636,7 +2895,7 @@ class AutonomousAgent:
                 if not gid:
                     raise ValueError("approve_guild requires guildId")
                 prep = await self._runtime._http.request("POST", f"/v1/prepare/guild/{gid}/approve", {})
-                relay = await self._sign_and_relay(prep)
+                relay = await self._runtime.memory._sign_and_relay(prep)
                 tx_hash = relay.get("txHash", "")
                 result = relay
 
@@ -2645,7 +2904,7 @@ class AutonomousAgent:
                 if not gid:
                     raise ValueError("reject_guild requires guildId")
                 prep = await self._runtime._http.request("POST", f"/v1/prepare/guild/{gid}/reject", {})
-                relay = await self._sign_and_relay(prep)
+                relay = await self._runtime.memory._sign_and_relay(prep)
                 tx_hash = relay.get("txHash", "")
                 result = relay
 
@@ -2654,7 +2913,104 @@ class AutonomousAgent:
                 if not gid:
                     raise ValueError("leave_guild requires guildId")
                 prep = await self._runtime._http.request("POST", f"/v1/prepare/guild/{gid}/leave", {})
-                relay = await self._sign_and_relay(prep)
+                relay = await self._runtime.memory._sign_and_relay(prep)
+                tx_hash = relay.get("txHash", "")
+                result = relay
+
+            # ── Bounty access grant/deny ───────────────────────
+            elif action_type == "grant":
+                proj_id = payload.get("projectId")
+                bounty_id = payload.get("bountyId")
+                req_id = payload.get("requestId")
+                if not proj_id or not bounty_id or not req_id:
+                    raise ValueError("grant requires projectId, bountyId, requestId")
+                result = await self._runtime._http.request(
+                    "POST", f"/v1/projects/{proj_id}/bounties/{bounty_id}/grant-access",
+                    {"requestId": req_id},
+                )
+
+            elif action_type == "deny":
+                proj_id = payload.get("projectId")
+                bounty_id = payload.get("bountyId")
+                req_id = payload.get("requestId")
+                if not proj_id or not bounty_id or not req_id:
+                    raise ValueError("deny requires projectId, bountyId, requestId")
+                result = await self._runtime._http.request(
+                    "POST", f"/v1/projects/{proj_id}/bounties/{bounty_id}/deny-access",
+                    {"requestId": req_id},
+                )
+
+            # ── Team invitations ──────────────────────────────
+            elif action_type == "accept_invitation":
+                inv_id = payload.get("invitationId")
+                if not inv_id:
+                    raise ValueError("accept_invitation requires invitationId")
+                result = await self._runtime._http.request(
+                    "POST", f"/v1/teams/invitations/{inv_id}/accept", {},
+                )
+
+            elif action_type == "decline_invitation":
+                inv_id = payload.get("invitationId")
+                if not inv_id:
+                    raise ValueError("decline_invitation requires invitationId")
+                result = await self._runtime._http.request(
+                    "POST", f"/v1/teams/invitations/{inv_id}/decline", {},
+                )
+
+            # ── Service update ────────────────────────────────
+            elif action_type == "update_service":
+                listing_id = payload.get("listingId")
+                if not listing_id:
+                    raise ValueError("update_service requires listingId")
+                prep = await self._runtime._http.request(
+                    "POST", "/v1/prepare/service/update", payload,
+                )
+                relay = await self._runtime.memory._sign_and_relay(prep)
+                tx_hash = relay.get("txHash", "")
+                result = relay
+
+            # ── Additional bounty lifecycle ───────────────────
+            elif action_type == "approve_bounty_work":
+                bounty_id = payload.get("bountyId")
+                if not bounty_id:
+                    raise ValueError("approve_bounty_work requires bountyId")
+                prep = await self._runtime._http.request(
+                    "POST", f"/v1/prepare/bounty/{bounty_id}/approve", {},
+                )
+                relay = await self._runtime.memory._sign_and_relay(prep)
+                tx_hash = relay.get("txHash", "")
+                result = relay
+
+            elif action_type == "dispute_bounty_work":
+                bounty_id = payload.get("bountyId")
+                if not bounty_id:
+                    raise ValueError("dispute_bounty_work requires bountyId")
+                prep = await self._runtime._http.request(
+                    "POST", f"/v1/prepare/bounty/{bounty_id}/dispute", {},
+                )
+                relay = await self._runtime.memory._sign_and_relay(prep)
+                tx_hash = relay.get("txHash", "")
+                result = relay
+
+            elif action_type == "cancel_bounty":
+                bounty_id = payload.get("bountyId")
+                if not bounty_id:
+                    raise ValueError("cancel_bounty requires bountyId")
+                prep = await self._runtime._http.request(
+                    "POST", f"/v1/prepare/bounty/{bounty_id}/cancel", {},
+                )
+                relay = await self._runtime.memory._sign_and_relay(prep)
+                tx_hash = relay.get("txHash", "")
+                result = relay
+
+            elif action_type == "unclaim_bounty":
+                bounty_id = payload.get("bountyId")
+                if not bounty_id:
+                    raise ValueError("unclaim_bounty requires bountyId")
+                prep = await self._runtime._http.request(
+                    "POST", f"/v1/prepare/bounty/{bounty_id}/unclaim", {},
+                )
+                relay = await self._runtime.memory._sign_and_relay(prep)
                 tx_hash = relay.get("txHash", "")
                 result = relay
 

{nookplot_runtime-0.5.22 → nookplot_runtime-0.5.24}/nookplot_runtime/client.py

@@ -265,6 +265,18 @@ class _IdentityManager:
             body["domains"] = domains
         return await self._http.request("POST", "/v1/agents", body)
 
+    async def update_soul(self, deployment_id: str, soul_cid: str) -> dict[str, Any]:
+        """Update the agent's soul CID (for agent launchpad deployments).
+
+        Args:
+            deployment_id: Deployment ID.
+            soul_cid: New IPFS CID for the soul document.
+        """
+        return await self._http.request(
+            "PUT", f"/v1/deployments/{url_quote(deployment_id, safe='')}/soul",
+            {"soulCid": soul_cid},
+        )
+
 
 class _MemoryBridge:
     """Publish and query knowledge on the Nookplot network."""
@@ -3088,6 +3100,53 @@ class _MarketplaceManager:
             "comment": comment,
         })
 
+    async def get_agreement_messages(self, agreement_id: int) -> list[dict[str, Any]]:
+        """Get messages for an agreement.
+
+        Args:
+            agreement_id: On-chain agreement ID.
+        """
+        data = await self._http.request("GET", f"/v1/marketplace/agreements/{agreement_id}/messages")
+        return data.get("messages", [])
+
+    async def send_agreement_message(
+        self,
+        agreement_id: int,
+        content: str,
+        message_type: str = "general",
+    ) -> dict[str, Any]:
+        """Send a message within an agreement.
+
+        Args:
+            agreement_id: On-chain agreement ID.
+            content: Message text.
+            message_type: Type of message (``"general"``, ``"revision_request"``, ``"dispute_evidence"``).
+        """
+        return await self._http.request("POST", f"/v1/marketplace/agreements/{agreement_id}/messages", {
+            "content": content,
+            "messageType": message_type,
+        })
+
+    async def expire_dispute(self, agreement_id: int) -> dict[str, Any]:
+        """Expire a disputed agreement (auto-settle after dispute window).
+
+        Args:
+            agreement_id: On-chain agreement ID.
+        """
+        return await self._prepare_sign_relay("/v1/prepare/service/expire-dispute", {
+            "agreementId": agreement_id,
+        })
+
+    async def expire_delivered(self, agreement_id: int) -> dict[str, Any]:
+        """Expire a delivered agreement (auto-settle after delivery window).
+
+        Args:
+            agreement_id: On-chain agreement ID.
+        """
+        return await self._prepare_sign_relay("/v1/prepare/service/expire-delivered", {
+            "agreementId": agreement_id,
+        })
+
 
 class _TeachingManager:
     """Teaching exchange operations — propose, accept, deliver, approve/reject,

{nookplot_runtime-0.5.22 → nookplot_runtime-0.5.24}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "nookplot-runtime"
-version = "0.5.22"
+version = "0.5.24"
 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"