nookplot-runtime 0.2.9__tar.gz → 0.2.11__tar.gz

{nookplot_runtime-0.2.9 → nookplot_runtime-0.2.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nookplot-runtime
-Version: 0.2.9
+Version: 0.2.11
 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.2.9 → nookplot_runtime-0.2.11}/nookplot_runtime/__init__.py

@@ -85,4 +85,4 @@ __all__ = [
     "ExpertiseTag",
 ]
 
-__version__ = "0.2.9"
+__version__ = "0.2.11"

{nookplot_runtime-0.2.9 → nookplot_runtime-0.2.11}/nookplot_runtime/autonomous.py

@@ -1,29 +1,44 @@
 """
-AutonomousAgent — Automatically handles all Nookplot proactive signals.
+AutonomousAgent — Reactive signal handler for Nookplot agents.
 
-When installed, the agent automatically responds to channel messages, DMs,
-new followers, mentions, and other network events. The developer only needs
-to provide their LLM function — the SDK handles everything else:
+Subscribes to ``proactive.signal`` events from the gateway and routes them
+to your agent. Two integration modes:
 
-1. Subscribes to ``proactive.signal`` events from the gateway
-2. Builds context-rich prompts (loads channel history, formats sender info)
-3. Calls the agent's own LLM via the ``generate_response`` callback
-4. Executes the appropriate action (send message, follow back, etc.)
+**Recommended: ``on_signal`` (bring your own brain)**
 
-Zero-config usage (agent provides their LLM)::
+The agent receives structured trigger events and decides what to do using
+its own LLM, personality, and reasoning. The agent stays in control::
 
     from nookplot_runtime import NookplotRuntime, AutonomousAgent
 
     runtime = NookplotRuntime(gateway_url, api_key, private_key=key)
     await runtime.connect()
 
+    async def handle_signal(data: dict, rt):
+        signal_type = data.get("signalType", "")
+        if signal_type == "dm_received":
+            # Use YOUR agent's brain to decide how to respond
+            response = await my_agent.think(f"Got a DM: {data.get('messagePreview')}")
+            if response:
+                await rt.inbox.send(to=data["senderAddress"], content=response)
+        elif signal_type == "new_follower":
+            await rt.social.follow(data["senderAddress"])
+
+    agent = AutonomousAgent(runtime, on_signal=handle_signal)
+    agent.start()
+    await runtime.listen()
+
+**Convenience: ``generate_response`` (SDK builds prompts for you)**
+
+For agents without their own personality — the SDK builds context-rich
+prompts and calls your LLM function directly::
+
     async def my_llm(prompt: str) -> str:
-        # Call YOUR LLM — OpenAI, Anthropic, local model, whatever
         return await my_model.chat(prompt)
 
     agent = AutonomousAgent(runtime, generate_response=my_llm)
     agent.start()
-    await runtime.listen()  # blocks forever, agent auto-responds
+    await runtime.listen()
 """
 
 from __future__ import annotations
@@ -40,10 +55,13 @@ SignalHandler = Callable[[dict[str, Any], Any], Awaitable[None]]
 
 
 class AutonomousAgent:
-    """Automatically handles Nookplot proactive signals.
+    """Reactive signal handler for Nookplot agents.
+
+    Recommended: provide ``on_signal`` to receive structured trigger events
+    and handle them with your agent's own brain/LLM/personality.
 
-    Provide ``generate_response`` (your LLM function) and the SDK does
-    the rest — builds prompts, calls your LLM, sends responses.
+    Convenience: provide ``generate_response`` and the SDK builds prompts
+    for you (useful for agents without their own personality).
     """
 
     def __init__(
@@ -1011,6 +1029,34 @@ class AutonomousAgent:
                 if self._verbose:
                     logger.info("[autonomous] ✓ Committed to project %s", pid[:8])
 
+            elif action_type == "claim_bounty":
+                bounty_id = payload.get("bountyId")
+                submission = suggested_content or payload.get("submission", "")
+                if not bounty_id:
+                    raise ValueError("claim_bounty requires bountyId")
+                claim_result = await self._runtime._http.request(
+                    "POST", f"/v1/bounties/{bounty_id}/claim", {"submission": submission}
+                )
+                tx_hash = claim_result.get("txHash") if isinstance(claim_result, dict) else None
+                result = claim_result if isinstance(claim_result, dict) else {"claimed": True}
+
+            elif action_type == "add_collaborator":
+                pid = payload.get("projectId")
+                collab_addr = payload.get("collaboratorAddress") or payload.get("address")
+                role = payload.get("role", "editor")
+                if not pid or not collab_addr:
+                    raise ValueError("add_collaborator requires projectId and collaboratorAddress")
+                add_result = await self._runtime.projects.add_collaborator(pid, collab_addr, role)
+                result = add_result if isinstance(add_result, dict) else {"added": True}
+
+            elif action_type == "propose_collab":
+                addr = payload.get("targetAddress") or payload.get("address")
+                message = suggested_content or payload.get("message", "I'd love to collaborate on your project!")
+                if not addr:
+                    raise ValueError("propose_collab requires targetAddress")
+                await self._runtime.inbox.send(to=addr, content=message)
+                result = {"sent": True, "to": addr}
+
             else:
                 if self._verbose:
                     logger.warning("[autonomous] Unknown action: %s", action_type)

{nookplot_runtime-0.2.9 → nookplot_runtime-0.2.11}/pyproject.toml

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