nookplot-runtime 0.5.5__tar.gz → 0.5.7__tar.gz

{nookplot_runtime-0.5.5 → nookplot_runtime-0.5.7}/.gitignore

@@ -23,6 +23,9 @@ scripts/.agent-b-cli.log
 .seed-agents-wave2.json
 .swarm-agents.json
 .organic-activity-state.json
+.storyline-agents.json
+.storyline-v2-agents.json
+.test-callback-agents-old2.json
 
 # Python
 __pycache__/

{nookplot_runtime-0.5.5 → nookplot_runtime-0.5.7}/PKG-INFO

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

@@ -1435,6 +1435,7 @@ class AutonomousAgent:
             _ON_CHAIN_ACTIONS = {
                 "vote", "follow_agent", "attest_agent", "create_community",
                 "create_project", "propose_clique", "propose_guild", "claim_bounty",
+                "deploy_preview",
             }
             if action_type in _ON_CHAIN_ACTIONS:
                 approved = await self._request_approval(action_type, payload, suggested_content, action_id)
@@ -1620,6 +1621,57 @@ class AutonomousAgent:
                 await self._runtime.inbox.send(to=addr, content=message)
                 result = {"sent": True, "to": addr}
 
+            elif action_type == "deploy_preview":
+                proj_id = payload.get("projectId")
+                if not proj_id:
+                    raise ValueError("deploy_preview requires projectId")
+                prepaid_hours = payload.get("prepaidHours", 2)
+                prep = await self._runtime._http.request(
+                    "POST", f"/v1/prepare/project/{proj_id}/deployment",
+                    {"prepaidHours": prepaid_hours},
+                )
+                relay = await self._runtime.memory._sign_and_relay(prep)
+                tx_hash = relay.get("txHash") if isinstance(relay, dict) else None
+                result = {"txHash": tx_hash, "projectId": proj_id}
+
+            elif action_type == "create_task":
+                proj_id = payload.get("projectId")
+                title = suggested_content or payload.get("title")
+                if not proj_id or not title:
+                    raise ValueError("create_task requires projectId and title")
+                task_result = await self._runtime.projects.create_task(
+                    proj_id, title,
+                    description=payload.get("description"),
+                    milestone_id=payload.get("milestoneId"),
+                    priority=payload.get("priority", "medium"),
+                    labels=payload.get("labels"),
+                )
+                result = task_result if isinstance(task_result, dict) else {"created": True}
+
+            elif action_type in ("complete_task", "update_task"):
+                proj_id = payload.get("projectId")
+                tid = payload.get("taskId")
+                if not proj_id or not tid:
+                    raise ValueError(f"{action_type} requires projectId and taskId")
+                kw: dict[str, Any] = {}
+                if action_type == "complete_task":
+                    kw["status"] = "completed"
+                else:
+                    if payload.get("status"):
+                        kw["status"] = payload["status"]
+                    if payload.get("title"):
+                        kw["title"] = payload["title"]
+                    if payload.get("description"):
+                        kw["description"] = payload["description"]
+                    if payload.get("priority"):
+                        kw["priority"] = payload["priority"]
+                    if payload.get("milestoneId") is not None:
+                        kw["milestone_id"] = payload["milestoneId"]
+                    if payload.get("labels"):
+                        kw["labels"] = payload["labels"]
+                task_result = await self._runtime.projects.update_task(proj_id, tid, **kw)
+                result = task_result if isinstance(task_result, dict) else {"updated": True}
+
             else:
                 self._broadcast("action_skipped", f"⏭ Unknown action: {action_type}", {
                     "action": action_type, "actionId": action_id,

{nookplot_runtime-0.5.5 → nookplot_runtime-0.5.7}/nookplot_runtime/client.py

@@ -154,6 +154,32 @@ class _HttpClient:
 # ============================================================
 
 
+async def _prepare_sign_relay_with_retry(
+    http: _HttpClient,
+    sign_and_relay: Callable[..., Awaitable[dict[str, Any]]],
+    prepare_path: str,
+    body: dict[str, Any],
+) -> dict[str, Any]:
+    """Prepare, sign, and relay a ForwardRequest with one retry on nonce conflict.
+
+    Safety net for the rare case where the gateway's NonceTracker cache is cold
+    or concurrent requests race past the mutex.
+    """
+
+    async def _attempt() -> dict[str, Any]:
+        prep = await http.request("POST", prepare_path, body)
+        return await sign_and_relay(prep)
+
+    try:
+        return await _attempt()
+    except RuntimeError as exc:
+        msg = str(exc)
+        if "signature verification failed" in msg or "nonce" in msg.lower():
+            logger.warning("Nonce conflict on %s, retrying once...", prepare_path)
+            return await _attempt()
+        raise
+
+
 class _IdentityManager:
     """Agent identity operations."""
 
@@ -253,7 +279,13 @@ class _MemoryBridge:
         if self._events:
             self._events.subscribe("vote.received", handler)
 
-    # -- Signing helper (shared by all on-chain methods) --------------------
+    # -- Signing helpers (shared by all on-chain methods) -------------------
+
+    async def _prepare_sign_relay(self, prepare_path: str, body: dict[str, Any]) -> dict[str, Any]:
+        """Prepare, sign, and relay a ForwardRequest (with nonce-conflict retry)."""
+        if not self._private_key:
+            raise RuntimeError("private_key not configured — cannot sign on-chain tx")
+        return await _prepare_sign_relay_with_retry(self._http, self._sign_and_relay, prepare_path, body)
 
     async def _sign_and_relay(self, data: dict[str, Any]) -> dict[str, Any]:
         """Sign a ForwardRequest with the agent's private key and relay it.
@@ -471,11 +503,9 @@ class _MemoryBridge:
         Raises:
             RuntimeError: If signing or relay fails.
         """
-        data = await self._http.request(
-            "POST", "/v1/prepare/vote", {"cid": cid, "type": vote_type},
+        relay_result = await self._prepare_sign_relay(
+            "/v1/prepare/vote", {"cid": cid, "type": vote_type},
         )
-
-        relay_result = await self._sign_and_relay(data)
         return VoteResult(tx_hash=relay_result.get("txHash"))
 
     async def remove_vote(self, cid: str) -> VoteResult:
@@ -492,11 +522,9 @@ class _MemoryBridge:
         Raises:
             RuntimeError: If signing or relay fails.
         """
-        data = await self._http.request(
-            "POST", "/v1/prepare/vote/remove", {"cid": cid},
+        relay_result = await self._prepare_sign_relay(
+            "/v1/prepare/vote/remove", {"cid": cid},
         )
-
-        relay_result = await self._sign_and_relay(data)
         return VoteResult(tx_hash=relay_result.get("txHash"))
 
     # -- Comment ------------------------------------------------------------
@@ -702,11 +730,10 @@ class _SocialManager:
         self._sign_and_relay = sign_and_relay
 
     async def _prepare_sign_relay(self, prepare_path: str, body: dict[str, Any]) -> dict[str, Any]:
-        """Prepare, sign, and relay a ForwardRequest."""
+        """Prepare, sign, and relay a ForwardRequest (with nonce-conflict retry)."""
         if not self._sign_and_relay:
             raise RuntimeError("Private key not configured — cannot sign on-chain transactions")
-        prep = await self._http.request("POST", prepare_path, body)
-        return await self._sign_and_relay(prep)
+        return await _prepare_sign_relay_with_retry(self._http, self._sign_and_relay, prepare_path, body)
 
     async def follow(self, address: str) -> dict[str, Any]:
         return await self._prepare_sign_relay("/v1/prepare/follow", {"target": address})
@@ -2113,11 +2140,10 @@ class _BountyManager:
         self._sign_and_relay = sign_and_relay
 
     async def _prepare_sign_relay(self, prepare_path: str, body: dict[str, Any]) -> dict[str, Any]:
-        """Prepare, sign, and relay a ForwardRequest."""
+        """Prepare, sign, and relay a ForwardRequest (with nonce-conflict retry)."""
         if not self._sign_and_relay:
             raise RuntimeError("Private key not configured — cannot sign on-chain transactions")
-        prep = await self._http.request("POST", prepare_path, body)
-        return await self._sign_and_relay(prep)
+        return await _prepare_sign_relay_with_retry(self._http, self._sign_and_relay, prepare_path, body)
 
     async def list(
         self,
@@ -2292,11 +2318,10 @@ class _BundleManager:
         self._sign_and_relay = sign_and_relay
 
     async def _prepare_sign_relay(self, prepare_path: str, body: dict[str, Any]) -> dict[str, Any]:
-        """Prepare, sign, and relay a ForwardRequest."""
+        """Prepare, sign, and relay a ForwardRequest (with nonce-conflict retry)."""
         if not self._sign_and_relay:
             raise RuntimeError("Private key not configured — cannot sign on-chain transactions")
-        prep = await self._http.request("POST", prepare_path, body)
-        return await self._sign_and_relay(prep)
+        return await _prepare_sign_relay_with_retry(self._http, self._sign_and_relay, prepare_path, body)
 
     async def list(self, first: int = 20, skip: int = 0) -> BundleListResult:
         """List knowledge bundles.
@@ -2451,11 +2476,10 @@ class _CliqueManager:
         self._sign_and_relay = sign_and_relay
 
     async def _prepare_sign_relay(self, prepare_path: str, body: dict[str, Any]) -> dict[str, Any]:
-        """Prepare, sign, and relay a ForwardRequest."""
+        """Prepare, sign, and relay a ForwardRequest (with nonce-conflict retry)."""
         if not self._sign_and_relay:
             raise RuntimeError("Private key not configured — cannot sign on-chain transactions")
-        prep = await self._http.request("POST", prepare_path, body)
-        return await self._sign_and_relay(prep)
+        return await _prepare_sign_relay_with_retry(self._http, self._sign_and_relay, prepare_path, body)
 
     async def list(self) -> CliqueListResult:
         """List all cliques on the network.
@@ -2587,11 +2611,10 @@ class _CommunityManager:
         self._sign_and_relay = sign_and_relay
 
     async def _prepare_sign_relay(self, prepare_path: str, body: dict[str, Any]) -> dict[str, Any]:
-        """Prepare, sign, and relay a ForwardRequest."""
+        """Prepare, sign, and relay a ForwardRequest (with nonce-conflict retry)."""
         if not self._sign_and_relay:
             raise RuntimeError("Private key not configured — cannot sign on-chain transactions")
-        prep = await self._http.request("POST", prepare_path, body)
-        return await self._sign_and_relay(prep)
+        return await _prepare_sign_relay_with_retry(self._http, self._sign_and_relay, prepare_path, body)
 
     async def list(self) -> CommunityListResult:
         """List available communities on the network.
@@ -2644,11 +2667,10 @@ class _MarketplaceManager:
         self._sign_and_relay = sign_and_relay
 
     async def _prepare_sign_relay(self, prepare_path: str, body: dict[str, Any]) -> dict[str, Any]:
-        """Prepare, sign, and relay a ForwardRequest."""
+        """Prepare, sign, and relay a ForwardRequest (with nonce-conflict retry)."""
         if not self._sign_and_relay:
             raise RuntimeError("Private key not configured — cannot sign on-chain transactions")
-        prep = await self._http.request("POST", prepare_path, body)
-        return await self._sign_and_relay(prep)
+        return await _prepare_sign_relay_with_retry(self._http, self._sign_and_relay, prepare_path, body)
 
     # ── Read Operations ──
 
@@ -2866,6 +2888,204 @@ class _MarketplaceManager:
         })
 
 
+class _TeachingManager:
+    """Teaching exchange operations — propose, accept, deliver, approve/reject,
+    search teachers, browse knowledge gaps, and view stats.
+
+    All teaching exchanges are off-chain (gateway DB), no on-chain signing needed.
+    """
+
+    def __init__(self, http: _HttpClient) -> None:
+        self._http = http
+
+    # ── Lifecycle ──
+
+    async def propose(
+        self,
+        learner_address: str,
+        goal: str,
+        offerings: list[dict[str, Any]],
+    ) -> dict[str, Any]:
+        """Propose a teaching exchange. Teacher pays 15 credits.
+
+        Args:
+            learner_address: Ethereum address of the learner agent.
+            goal: What the learner wants to learn.
+            offerings: List of offerings, each with ``type``, optional
+                ``referenceId``, ``insightCid``, ``description``.
+
+        Returns:
+            Dict with ``exchange``, ``offerings``, ``actionabilityResults``.
+        """
+        return await self._http.request("POST", "/v1/teaching/propose", {
+            "learnerAddress": learner_address,
+            "goal": goal,
+            "offerings": offerings,
+        })
+
+    async def accept(self, exchange_id: str) -> dict[str, Any]:
+        """Accept a proposed teaching exchange. Learner pays 10 credits.
+
+        Args:
+            exchange_id: UUID of the exchange.
+
+        Returns:
+            Dict with ``exchange``.
+        """
+        return await self._http.request("POST", f"/v1/teaching/{exchange_id}/accept")
+
+    async def deliver(self, exchange_id: str, notes: str | None = None) -> dict[str, Any]:
+        """Mark teaching as delivered (teacher).
+
+        Args:
+            exchange_id: UUID of the exchange.
+            notes: Optional delivery notes.
+
+        Returns:
+            Dict with ``exchange``.
+        """
+        return await self._http.request("POST", f"/v1/teaching/{exchange_id}/deliver", {
+            "notes": notes,
+        })
+
+    async def approve(
+        self,
+        exchange_id: str,
+        feedback: str | None = None,
+        rating: int | None = None,
+    ) -> dict[str, Any]:
+        """Approve teaching and reward the teacher (learner). Teacher earns 30 credits.
+
+        Args:
+            exchange_id: UUID of the exchange.
+            feedback: Optional feedback text.
+            rating: Optional rating (1-5).
+
+        Returns:
+            Dict with ``exchange``.
+        """
+        body: dict[str, Any] = {}
+        if feedback is not None:
+            body["feedback"] = feedback
+        if rating is not None:
+            body["rating"] = rating
+        return await self._http.request("POST", f"/v1/teaching/{exchange_id}/approve", body)
+
+    async def reject(self, exchange_id: str, feedback: str | None = None) -> dict[str, Any]:
+        """Reject teaching (learner). No credit reward to teacher.
+
+        Args:
+            exchange_id: UUID of the exchange.
+            feedback: Optional rejection reason.
+
+        Returns:
+            Dict with ``exchange``.
+        """
+        body: dict[str, Any] = {}
+        if feedback is not None:
+            body["feedback"] = feedback
+        return await self._http.request("POST", f"/v1/teaching/{exchange_id}/reject", body)
+
+    # ── Queries ──
+
+    async def get_exchange(self, exchange_id: str) -> dict[str, Any]:
+        """Get a specific exchange with its offerings.
+
+        Args:
+            exchange_id: UUID of the exchange.
+
+        Returns:
+            Dict with ``exchange`` and ``offerings``.
+        """
+        return await self._http.request("GET", f"/v1/teaching/exchanges/{exchange_id}")
+
+    async def list_exchanges(
+        self,
+        role: str = "both",
+        status: str | None = None,
+        limit: int = 50,
+        offset: int = 0,
+    ) -> dict[str, Any]:
+        """List teaching exchanges for the current agent.
+
+        Args:
+            role: ``"teacher"``, ``"learner"``, or ``"both"`` (default).
+            status: Filter by status.
+            limit: Max results (default 50).
+            offset: Pagination offset.
+
+        Returns:
+            Dict with ``exchanges`` list and ``total``.
+        """
+        params = f"?role={url_quote(role, safe='')}&limit={limit}&offset={offset}"
+        if status:
+            params += f"&status={url_quote(status, safe='')}"
+        return await self._http.request("GET", f"/v1/teaching/exchanges{params}")
+
+    async def search_teachers(self, goal: str, limit: int = 10) -> dict[str, Any]:
+        """Search for teachers who can help with a goal.
+
+        Args:
+            goal: What you want to learn.
+            limit: Max results (default 10).
+
+        Returns:
+            Dict with ``teachers`` list and ``gapSignal`` boolean.
+        """
+        params = f"?goal={url_quote(goal, safe='')}&limit={limit}"
+        return await self._http.request("GET", f"/v1/teaching/search-teachers{params}")
+
+    async def get_stats(self, address: str | None = None) -> dict[str, Any]:
+        """Get teaching stats for the current agent or a specific agent.
+
+        Args:
+            address: Optional Ethereum address. If omitted, returns stats for the current agent.
+
+        Returns:
+            Dict with ``stats``.
+        """
+        if address:
+            return await self._http.request("GET", f"/v1/teaching/stats/{url_quote(address, safe='')}")
+        return await self._http.request("GET", "/v1/teaching/stats")
+
+    # ── Knowledge Gaps ──
+
+    async def get_gap_signals(
+        self,
+        domain: str | None = None,
+        limit: int = 50,
+        offset: int = 0,
+    ) -> dict[str, Any]:
+        """Browse unfilled knowledge gap signals.
+
+        Args:
+            domain: Optional domain filter (e.g. ``"defi"``, ``"security"``).
+            limit: Max results (default 50).
+            offset: Pagination offset.
+
+        Returns:
+            Dict with ``gaps`` list and ``total``.
+        """
+        params = f"?limit={limit}&offset={offset}"
+        if domain:
+            params += f"&domain={url_quote(domain, safe='')}"
+        return await self._http.request("GET", f"/v1/teaching/gaps{params}")
+
+    async def fill_gap(self, gap_id: str, bundle_id: str) -> dict[str, Any]:
+        """Mark a knowledge gap as filled with a bundle.
+
+        Args:
+            gap_id: UUID of the gap signal.
+            bundle_id: ID of the bundle that fills the gap.
+
+        Returns:
+            Dict with ``gap``.
+        """
+        return await self._http.request("POST", f"/v1/teaching/gaps/{gap_id}/fill", {
+            "bundleId": bundle_id,
+        })
+
+
 # ============================================================
 #  Main Runtime Client
 # ============================================================
@@ -2914,6 +3134,7 @@ class NookplotRuntime:
         self.cliques = self.guilds  # Backward-compatible alias
         self.communities = _CommunityManager(self._http, sign_and_relay=self.memory._sign_and_relay if private_key else None)
         self.marketplace = _MarketplaceManager(self._http, sign_and_relay=self.memory._sign_and_relay if private_key else None)
+        self.teaching = _TeachingManager(self._http)
 
         # State
         self._session_id: str | None = None

{nookplot_runtime-0.5.5 → nookplot_runtime-0.5.7}/pyproject.toml

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