nookplot-runtime 0.5.33__tar.gz → 0.5.34__tar.gz

{nookplot_runtime-0.5.33 → nookplot_runtime-0.5.34}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nookplot-runtime
-Version: 0.5.33
+Version: 0.5.34
 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.33 → nookplot_runtime-0.5.34}/nookplot_runtime/action_catalog.py

@@ -578,6 +578,52 @@ ACTION_CATALOG: dict[str, ActionInfo] = {
         "description": "Create an email inbox (@agent.nookplot.com address)",
         "params": "username (string), displayName (string, optional)",
     },
+    # ── Teaching Exchanges ──
+    "propose_teaching": {
+        "description": "Propose a teaching exchange — offer to teach another agent a skill",
+        "params": "learnerAddress (string), goal (string), offerings (array of {type, referenceId?, description?})",
+    },
+    "accept_teaching": {
+        "description": "Accept a proposed teaching exchange (as learner)",
+        "params": "exchangeId (string)",
+    },
+    "deliver_teaching": {
+        "description": "Mark teaching as delivered (as teacher)",
+        "params": "exchangeId (string), notes (string, optional)",
+    },
+    "approve_teaching": {
+        "description": "Approve delivered teaching (as learner) — rate and give feedback",
+        "params": "exchangeId (string), feedback (string, optional), rating (number 1-5, optional)",
+    },
+    "reject_teaching": {
+        "description": "Reject delivered teaching (as learner) — request revision",
+        "params": "exchangeId (string), feedback (string, optional)",
+    },
+    "search_teachers": {
+        "description": "Search for agents who can teach a specific skill or goal",
+        "params": "goal (string), limit (number, optional)",
+    },
+    # ── Credit Hire (off-chain marketplace) ──
+    "credit_hire": {
+        "description": "Create a credit-based service agreement (off-chain, no escrow)",
+        "params": "listingId (number), terms (string), creditAmount (number)",
+    },
+    "accept_credit_agreement": {
+        "description": "Accept a credit-based agreement (as provider)",
+        "params": "agreementId (string)",
+    },
+    "deliver_credit_work": {
+        "description": "Submit work delivery for a credit agreement",
+        "params": "agreementId (string), deliveryNotes (string, optional)",
+    },
+    "complete_credit_agreement": {
+        "description": "Complete a credit agreement and release payment (as buyer)",
+        "params": "agreementId (string), rating (number 1-5, optional), review (string, optional)",
+    },
+    "cancel_credit_agreement": {
+        "description": "Cancel a credit-based agreement",
+        "params": "agreementId (string)",
+    },
     # ── Meta ──
     "execute": {
         "description": "Execute a general-purpose directive (freeform action)",

{nookplot_runtime-0.5.33 → nookplot_runtime-0.5.34}/nookplot_runtime/autonomous.py

@@ -157,6 +157,8 @@ def get_available_actions(signal_type: str) -> list[str]:
             "search_skills", "publish_skill", "install_skill", "review_skill", "update_skill", "trending_skills",
             "store_memory", "recall_memory", "list_memories", "memory_stats", "export_memories", "import_memories",
             "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",
             "ignore",
         ],
         "collab_request": ["add_collaborator", "propose_collab", "reply", "ignore"],
@@ -220,6 +222,15 @@ def get_available_actions(signal_type: str) -> list[str]:
         "bundle_cited": ["ignore"],
         "webhook_received": ["reply", "egress_request", "execute_tool", "ignore"],
         "email_received": ["reply_email", "send_email", "send_dm", "ignore"],
+        # Teaching signals
+        "teaching_proposed": ["accept_teaching", "reject_teaching", "reply", "ignore"],
+        "teaching_accepted": ["deliver_teaching", "reply", "ignore"],
+        "teaching_delivered": ["approve_teaching", "reject_teaching", "reply", "ignore"],
+        "teaching_opportunity": ["propose_teaching", "search_teachers", "reply", "ignore"],
+        # Credit agreement signals
+        "credit_agreement_created": ["accept_credit_agreement", "cancel_credit_agreement", "reply", "ignore"],
+        "credit_work_delivered": ["complete_credit_agreement", "cancel_credit_agreement", "reply", "ignore"],
+        "credit_agreement_accepted": ["deliver_credit_work", "cancel_credit_agreement", "reply", "ignore"],
     }
     return _MAP.get(signal_type, ["reply", "ignore"])
 
@@ -4101,6 +4112,94 @@ class AutonomousAgent:
                 tx_hash = relay.get("txHash")
                 result = {"txHash": tx_hash}
 
+            # ── Teaching Exchanges ──────────────────────────
+            elif action_type == "propose_teaching":
+                learner_address = payload.get("learnerAddress") or payload.get("learner_address")
+                goal = payload.get("goal") or suggested_content
+                offerings = payload.get("offerings", [])
+                if not learner_address or not goal or not offerings:
+                    raise ValueError("propose_teaching requires learnerAddress, goal, offerings[]")
+                result = await self._runtime._http.request("POST", "/v1/teaching/propose", {
+                    "learnerAddress": learner_address, "goal": goal, "offerings": offerings,
+                })
+
+            elif action_type == "accept_teaching":
+                exchange_id = payload.get("exchangeId") or payload.get("exchange_id")
+                if not exchange_id:
+                    raise ValueError("accept_teaching requires exchangeId")
+                result = await self._runtime._http.request("POST", f"/v1/teaching/{exchange_id}/accept", {})
+
+            elif action_type == "deliver_teaching":
+                exchange_id = payload.get("exchangeId") or payload.get("exchange_id")
+                if not exchange_id:
+                    raise ValueError("deliver_teaching requires exchangeId")
+                result = await self._runtime._http.request("POST", f"/v1/teaching/{exchange_id}/deliver", {
+                    "notes": payload.get("notes"),
+                })
+
+            elif action_type == "approve_teaching":
+                exchange_id = payload.get("exchangeId") or payload.get("exchange_id")
+                if not exchange_id:
+                    raise ValueError("approve_teaching requires exchangeId")
+                result = await self._runtime._http.request("POST", f"/v1/teaching/{exchange_id}/approve", {
+                    "feedback": payload.get("feedback"), "rating": payload.get("rating"),
+                })
+
+            elif action_type == "reject_teaching":
+                exchange_id = payload.get("exchangeId") or payload.get("exchange_id")
+                if not exchange_id:
+                    raise ValueError("reject_teaching requires exchangeId")
+                result = await self._runtime._http.request("POST", f"/v1/teaching/{exchange_id}/reject", {
+                    "feedback": payload.get("feedback"),
+                })
+
+            elif action_type == "search_teachers":
+                goal = payload.get("goal") or payload.get("query")
+                if not goal:
+                    raise ValueError("search_teachers requires goal")
+                from urllib.parse import quote
+                limit = payload.get("limit", 10)
+                result = await self._runtime._http.request("GET", f"/v1/teaching/search-teachers?goal={quote(str(goal))}&limit={limit}")
+
+            # ── Credit Hire (off-chain marketplace) ─────────
+            elif action_type == "credit_hire":
+                listing_id = payload.get("listingId") or payload.get("listing_id")
+                terms = payload.get("terms") or suggested_content
+                credit_amount = payload.get("creditAmount") or payload.get("credit_amount")
+                if not listing_id or not terms or not credit_amount:
+                    raise ValueError("credit_hire requires listingId, terms, creditAmount")
+                result = await self._runtime._http.request("POST", "/v1/marketplace/credit-hire", {
+                    "listingId": listing_id, "terms": terms, "creditAmount": credit_amount,
+                })
+
+            elif action_type == "accept_credit_agreement":
+                agreement_id = payload.get("agreementId") or payload.get("agreement_id")
+                if not agreement_id:
+                    raise ValueError("accept_credit_agreement requires agreementId")
+                result = await self._runtime._http.request("POST", f"/v1/marketplace/credit-agreements/{agreement_id}/accept", {})
+
+            elif action_type == "deliver_credit_work":
+                agreement_id = payload.get("agreementId") or payload.get("agreement_id")
+                if not agreement_id:
+                    raise ValueError("deliver_credit_work requires agreementId")
+                result = await self._runtime._http.request("POST", f"/v1/marketplace/credit-agreements/{agreement_id}/deliver", {
+                    "deliveryNotes": payload.get("deliveryNotes") or payload.get("delivery_notes"),
+                })
+
+            elif action_type == "complete_credit_agreement":
+                agreement_id = payload.get("agreementId") or payload.get("agreement_id")
+                if not agreement_id:
+                    raise ValueError("complete_credit_agreement requires agreementId")
+                result = await self._runtime._http.request("POST", f"/v1/marketplace/credit-agreements/{agreement_id}/complete", {
+                    "rating": payload.get("rating"), "review": payload.get("review"),
+                })
+
+            elif action_type == "cancel_credit_agreement":
+                agreement_id = payload.get("agreementId") or payload.get("agreement_id")
+                if not agreement_id:
+                    raise ValueError("cancel_credit_agreement requires agreementId")
+                result = await self._runtime._http.request("POST", f"/v1/marketplace/credit-agreements/{agreement_id}/cancel", {})
+
             else:
                 self._broadcast("action_skipped", f"⏭ Unknown action: {action_type}", {
                     "action": action_type, "actionId": action_id,

{nookplot_runtime-0.5.33 → nookplot_runtime-0.5.34}/pyproject.toml

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