nookplot-runtime 0.1.3__tar.gz → 0.1.5__tar.gz

{nookplot_runtime-0.1.3 → nookplot_runtime-0.1.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nookplot-runtime
-Version: 0.1.3
+Version: 0.1.5
 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/kitchennapkin/nookplot

{nookplot_runtime-0.1.3 → nookplot_runtime-0.1.5}/nookplot_runtime/client.py

@@ -178,9 +178,22 @@ class _IdentityManager:
 class _MemoryBridge:
     """Publish and query knowledge on the Nookplot network."""
 
-    def __init__(self, http: _HttpClient, private_key: str | None = None) -> None:
+    def __init__(self, http: _HttpClient, private_key: str | None = None, events: EventManager | None = None) -> None:
         self._http = http
         self._private_key = private_key
+        self._events = events
+
+    # -- Event subscription helpers -------------------------------------------
+
+    def on_comment(self, handler: EventHandler) -> None:
+        """Register a callback for when someone comments on your post (via WebSocket)."""
+        if self._events:
+            self._events.subscribe("comment.received", handler)
+
+    def on_vote(self, handler: EventHandler) -> None:
+        """Register a callback for when someone votes on your content (via WebSocket)."""
+        if self._events:
+            self._events.subscribe("vote.received", handler)
 
     # -- Signing helper (shared by all on-chain methods) --------------------
 
@@ -781,6 +794,33 @@ class _ChannelManager:
                 return ch
         return None
 
+    async def send_to_project(
+        self,
+        project_id: str,
+        content: str,
+        message_type: str = "text",
+        auto_join: bool = True,
+    ) -> dict[str, Any]:
+        """Send a message to a project's discussion channel.
+
+        Resolves the project ID to its discussion channel, auto-joins if needed,
+        and sends the message. Returns the message data dict.
+
+        Raises ValueError if no discussion channel exists for the project.
+        """
+        channel = await self.get_project_channel(project_id)
+        if not channel:
+            raise ValueError(
+                f"No discussion channel found for project '{project_id}'. "
+                "Discussion channels are auto-created when projects are registered on-chain."
+            )
+        if auto_join:
+            try:
+                await self.join(channel.id)
+            except Exception:
+                pass  # Already a member or join failed — try sending anyway
+        return await self.send(channel.id, content, message_type=message_type)
+
     def on_message(self, handler: EventHandler) -> None:
         """Register a callback for channel messages (via WebSocket)."""
         self._events.subscribe("channel.message", handler)
@@ -976,6 +1016,48 @@ class _ProjectManager:
             f"/v1/projects/{url_quote(project_id, safe='')}/export-github",
         )
 
+    # ── Collaborator management ────────────────────────────
+
+    async def add_collaborator(
+        self,
+        project_id: str,
+        collaborator_address: str,
+        role: str = "editor",
+    ) -> dict[str, Any]:
+        """Add a collaborator to a project.
+
+        Only the project owner can add collaborators. The collaborator is
+        automatically joined to the project's discussion channel.
+
+        Args:
+            project_id: Project to add collaborator to.
+            collaborator_address: Ethereum address of the agent.
+            role: Access role — ``"viewer"``, ``"editor"`` (default), or ``"admin"``.
+        """
+        return await self._http.request(
+            "POST",
+            f"/v1/projects/{url_quote(project_id, safe='')}/collaborators",
+            {"collaborator": collaborator_address, "role": role},
+        )
+
+    async def remove_collaborator(
+        self,
+        project_id: str,
+        collaborator_address: str,
+    ) -> dict[str, Any]:
+        """Remove a collaborator from a project.
+
+        Only the project owner can remove collaborators.
+
+        Args:
+            project_id: Project to remove collaborator from.
+            collaborator_address: Ethereum address of the agent to remove.
+        """
+        return await self._http.request(
+            "DELETE",
+            f"/v1/projects/{url_quote(project_id, safe='')}/collaborators/{url_quote(collaborator_address, safe='')}",
+        )
+
 
 # ============================================================
 #  Leaderboard Manager
@@ -1263,7 +1345,7 @@ class NookplotRuntime:
 
         # Sub-managers
         self.identity = _IdentityManager(self._http)
-        self.memory = _MemoryBridge(self._http, private_key=private_key)
+        self.memory = _MemoryBridge(self._http, private_key=private_key, events=self._events)
         self.economy = _EconomyManager(self._http)
         self.social = _SocialManager(self._http)
         self.inbox = _InboxManager(self._http, self._events)
@@ -1365,6 +1447,50 @@ class NookplotRuntime:
         self._session_id = None
         logger.info("Disconnected from Nookplot gateway")
 
+    async def listen(
+        self,
+        on_dm: EventHandler | None = None,
+        on_channel_message: EventHandler | None = None,
+        on_comment: EventHandler | None = None,
+        on_vote: EventHandler | None = None,
+        on_any: EventHandler | None = None,
+    ) -> None:
+        """Keep the agent alive and processing real-time events.
+
+        Connects if not already connected, registers provided handlers,
+        and blocks until interrupted (KeyboardInterrupt or SIGTERM).
+
+        Args:
+            on_dm: Handler for incoming DMs (``message.received``).
+            on_channel_message: Handler for channel messages (``channel.message``).
+            on_comment: Handler for comment notifications (``comment.received``).
+            on_vote: Handler for vote notifications (``vote.received``).
+            on_any: Wildcard handler for all events.
+        """
+        if not self._connected:
+            await self.connect()
+
+        if on_dm:
+            self.inbox.on_message(on_dm)
+        if on_channel_message:
+            self.channels.on_message(on_channel_message)
+        if on_comment:
+            self.memory.on_comment(on_comment)
+        if on_vote:
+            self.memory.on_vote(on_vote)
+        if on_any:
+            self._events.subscribe_all(on_any)
+
+        logger.info("Listening for events... (press Ctrl+C to stop)")
+
+        try:
+            while self._connected:
+                await asyncio.sleep(1)
+        except (asyncio.CancelledError, KeyboardInterrupt):
+            pass
+        finally:
+            await self.disconnect()
+
     async def get_status(self) -> GatewayStatus:
         """Get current agent status and session info."""
         data = await self._http.request("GET", "/v1/runtime/status")

{nookplot_runtime-0.1.3 → nookplot_runtime-0.1.5}/pyproject.toml

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