nookplot-runtime 0.5.88__tar.gz → 0.5.89__tar.gz

{nookplot_runtime-0.5.88 → nookplot_runtime-0.5.89}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nookplot-runtime
-Version: 0.5.88
+Version: 0.5.89
 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.89/nookplot_runtime/knowledge_context.py

@@ -0,0 +1,103 @@
+"""
+Knowledge Context — auto-retrieves relevant compiled knowledge for task augmentation.
+
+Before an agent processes a task, call ``get_knowledge_context(runtime, task_description)``
+to fetch the top relevant items from the agent's compiled knowledge graph. Returns a
+compact markdown string (~400 tokens) ready for injection into the agent's prompt.
+
+Usage::
+
+    from nookplot_runtime.knowledge_context import get_knowledge_context
+
+    ctx = await get_knowledge_context(runtime, "review this code for security issues")
+    if ctx["available"]:
+        prompt = ctx["markdown"] + "\\n\\n" + original_prompt
+"""
+
+from __future__ import annotations
+
+from typing import Any
+from urllib.parse import quote
+
+
+# Defaults
+MAX_ITEMS = 5
+MIN_SCORE = 0.6
+MIN_QUALITY = 50
+MAX_SNIPPET = 120
+
+
+async def get_knowledge_context(
+    runtime: Any,
+    task_description: str,
+    *,
+    max_items: int = MAX_ITEMS,
+    min_score: float = MIN_SCORE,
+    min_quality: float = MIN_QUALITY,
+) -> dict[str, Any]:
+    """Retrieve relevant compiled knowledge for a task.
+
+    Returns a dict with:
+        markdown (str): Compact markdown context for prompt injection
+        item_ids (list[str]): Item UUIDs for citation tracking
+        count (int): Number of items retrieved
+        available (bool): Whether any relevant context was found
+    """
+    empty: dict[str, Any] = {"markdown": "", "item_ids": [], "count": 0, "available": False}
+
+    if not task_description or len(task_description.strip()) < 3:
+        return empty
+
+    try:
+        q = quote(task_description[:200], safe="")
+        data = await runtime._http.request(
+            "GET",
+            f"/v1/agents/me/knowledge?q={q}&limit={max_items * 2}&include_public=false",
+        )
+
+        results = data.get("results", []) if isinstance(data, dict) else []
+        if not results:
+            return empty
+
+        # Filter by relevance + quality
+        filtered = []
+        for r in results:
+            score = r.get("score", 0)
+            item = r.get("item", {})
+            qs = item.get("qualityScore")
+            if score >= min_score and (qs is None or qs >= min_quality):
+                filtered.append(r)
+            if len(filtered) >= max_items:
+                break
+
+        if not filtered:
+            return empty
+
+        # Build compact markdown
+        lines = ["## Your compiled knowledge (auto-retrieved)", ""]
+        item_ids: list[str] = []
+
+        for i, r in enumerate(filtered):
+            item = r.get("item", {})
+            title = item.get("title") or (item.get("contentText", "")[:60])
+            domain = item.get("domain")
+            domain_prefix = f"[{domain}] " if domain else ""
+            snippet = item.get("contentText", "")[:MAX_SNIPPET].replace("\n", " ").strip()
+            lines.append(f"{i + 1}. {domain_prefix}**{title}** — {snippet}")
+            item_ids.append(item.get("id", ""))
+
+        return {
+            "markdown": "\n".join(lines),
+            "item_ids": item_ids,
+            "count": len(filtered),
+            "available": True,
+        }
+
+    except Exception as exc:
+        # Non-fatal — agent proceeds without knowledge context
+        # Log for debugging (don't raise — context injection is advisory)
+        import logging
+        logging.getLogger("nookplot_runtime").warning(
+            "Knowledge context retrieval failed: %s", exc
+        )
+        return empty

{nookplot_runtime-0.5.88 → nookplot_runtime-0.5.89}/pyproject.toml

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