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

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

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

@@ -1914,7 +1914,7 @@ GENERATED_CATALOG: dict[str, ActionInfo] = {
     },
     "store_knowledge_item": {
         "description": "Store a knowledge item in your personal graph. Use this after completing tasks, learning something new, or gaining insights.\n**Free** — no credits charged.\n**Important:** Always include a domain and tags — items without domains can't be consolidated or cross-linked by the compiler.\n**Next:** Link related items with nookplot_add_knowledge_citation.",
-        "params": "contentText (string), knowledgeType (string, optional), sourceType (string, optional), domain (string, optional), tags (array, optional), importance (number, optional), confidence (number, optional)",
+        "params": "contentText (string), knowledgeType (string, optional), sourceType (string, optional), domain (string, optional), tags (array, optional), importance (number, optional), confidence (number, optional), sourceItemIds (array, optional), title (string, optional)",
         "category": "knowledge",
     },
     "get_knowledge_item": {
@@ -1933,7 +1933,7 @@ GENERATED_CATALOG: dict[str, ActionInfo] = {
         "category": "knowledge",
     },
     "compile_knowledge": {
-        "description": "Organize your knowledge — consolidates domain clusters, cross-links items, regenerates your index, and runs quality checks.\n**Free** — no credits charged.\n**When to use:** After storing 5+ items.\n**Response includes:** `lint.totalActive` (issue count), `lint.byType` (breakdown), and `lintFindings` (top 10 issues with itemId, lintType, description).\n**Act on findings:**\n- metadata_gap → `nookplot_update_knowledge_item(itemId, domain/tags/title)`\n- stale or low_quality → `nookplot_archive_knowledge_item(itemId)`\n- near_duplicate → archive the lower-importance item\n- contradiction → archive the outdated item, or leave both if valid",
+        "description": "Synthesize your knowledge — returns items that need real synthesis, grouped by domain.\n**YOUR JOB:** Read the items, find patterns/insights/connections across them, then store each synthesis via `nookplot_store_knowledge_item` with `knowledgeType: 'synthesis'`.\n**Output format:** Write rich markdown — headers, bullet points, code blocks, tables. Find patterns, contradictions, key takeaways, and actionable insights.\n**Free** — no credits charged.\n**When to use:** After storing 5+ items, or periodically to maintain your knowledge.\n**Mechanical work done for you:** Cross-linking, embedding backfill, and linting run automatically.\n**Act on lint findings:**\n- metadata_gap → `nookplot_update_knowledge_item(itemId, domain/tags/title)`\n- stale or low_quality → `nookplot_archive_knowledge_item(itemId)`\n- near_duplicate → archive the lower-importance item\n- contradiction → archive the outdated item, or leave both if valid",
         "category": "knowledge",
     },
     "update_knowledge_item": {

{nookplot_runtime-0.5.89 → nookplot_runtime-0.5.91}/nookplot_runtime/autonomous.py

@@ -602,6 +602,9 @@ class AutonomousAgent:
         # ── File sharing signals ──
         elif signal_type == "file_shared":
             await self._handle_file_shared(data)
+        # ── Knowledge dream prompts ──
+        elif signal_type == "dream_prompt":
+            await self._handle_dream_prompt(data)
         else:
             self._broadcast("action_skipped", f"⏭ Unhandled signal type: {signal_type}", {
                 "signalType": signal_type,
@@ -2034,6 +2037,48 @@ class AutonomousAgent:
                 "action": "file_shared", "error": str(exc),
             })
 
+    # ── Knowledge dream prompt handler ──
+
+    async def _handle_dream_prompt(self, data: dict[str, Any]) -> None:
+        """Handle idle-time knowledge exploration — search domains, find connections, store insights."""
+        dream_type = data.get("dreamType", "gap_bridge")
+        prompt_text = data.get("prompt", data.get("message", ""))
+        domains = data.get("domains", [])
+
+        if not prompt_text:
+            return
+
+        try:
+            domain_ctx = f"Domains involved: {', '.join(domains)}\n" if domains else ""
+
+            prompt = (
+                "KNOWLEDGE DREAM — Idle-time exploration\n\n"
+                f"{wrap_untrusted(str(prompt_text)[:500], 'dream prompt')}\n\n"
+                f"{domain_ctx}"
+                "Your task:\n"
+                "1. Search your knowledge for the domains mentioned above (use search_knowledge)\n"
+                "2. Think about connections, patterns, or gaps\n"
+                "3. If you discover an insight, store it (use store_knowledge_item with rich markdown)\n"
+                "4. Optionally run compile_knowledge to organize everything\n\n"
+                "Available actions:\n"
+                "- search_knowledge: Search your knowledge graph\n"
+                "- store_knowledge_item: Store a new insight\n"
+                "- compile_knowledge: Run full knowledge synthesis\n"
+                "- get_knowledge_stats: Check your knowledge overview\n"
+                "- ignore: Take no action\n\n"
+                "Format:\nACTION: <action_type>\nPARAMS: <json params>"
+            )
+
+            assert self._generate_response is not None
+            response = await self._generate_response(prompt)
+            text = (response or "").strip()
+            if text:
+                await self._parse_and_execute_action(text)
+        except Exception as exc:
+            self._broadcast("error", f"Dream prompt handling failed: {exc}", {
+                "action": "dream_prompt", "error": str(exc),
+            })
+
     # ── Bounty application/submission signal handlers ──
 
     async def _handle_bounty_application_submitted(self, data: dict[str, Any]) -> None:

{nookplot_runtime-0.5.89 → nookplot_runtime-0.5.91}/nookplot_runtime/client.py

@@ -5452,8 +5452,88 @@ class NookplotRuntime:
             self._agent_id,
             self._address,
         )
+
+        # CLI-1 fix: auto-load forge knowledge after connect (same as CLI agentLoop).
+        # Non-fatal — agent works without preset knowledge if this fails.
+        try:
+            await self.load_forge_knowledge()
+        except Exception:
+            pass  # load_forge_knowledge already handles its own error logging
+
         return result
 
+    async def load_forge_knowledge(self) -> dict[str, Any] | None:
+        """Load forge preset knowledge into the agent's personal KG.
+
+        If this agent has a forge deployment with a linked preset,
+        fetches the preset data and ingests it server-side into the
+        personal knowledge graph. Idempotent — safe to call on every boot.
+
+        Returns the KG result dict or None if no preset is linked.
+        Raises no exceptions — failures are logged and silently skipped.
+        """
+        if not self._address:
+            return None
+        try:
+            # Find agent's deployments
+            dep_data = await self._http.request(
+                "GET",
+                f"/v1/forge?first=1&skip=0&creator={self._address}",
+            )
+            deployments = dep_data.get("deployments", [])
+            if not deployments:
+                return None
+
+            # Find linked preset
+            presets_data = await self._http.request(
+                "GET",
+                f"/v1/forge/presets?creator={self._address}&first=1",
+            )
+            presets = presets_data.get("presets", [])
+            if not presets:
+                return None
+
+            preset = presets[0]
+            preset_id = preset.get("preset_id")
+            if not preset_id:
+                return None
+
+            # Build sources from preset config
+            ds_config = preset.get("dataset_config") or {}
+            raw_sources = ds_config.get("sources", [])
+            if raw_sources:
+                sources = [{"type": s["type"], "config": s.get("config", {})} for s in raw_sources]
+            else:
+                sources = [{"type": preset.get("source_type", "mining"), "config": {}}]
+
+            # Fetch + ingest in one call
+            result = await self._http.request("POST", "/v1/forge/data/fetch", {
+                "presetId": preset_id,
+                "sources": sources,
+                "ingestToKg": True,
+            })
+
+            kg_result = result.get("kgResult")
+            if kg_result:
+                ingested = kg_result.get("ingested", 0)
+                blocked = kg_result.get("blocked", 0)
+                if ingested > 0:
+                    logger.info("[knowledge] Loaded %d items into personal KG", ingested)
+                if blocked > 0:
+                    logger.warning("[knowledge] %d items blocked by safety scanner", blocked)
+            return kg_result
+        except Exception as exc:
+            # Non-fatal — agent still works without preset knowledge
+            msg = str(exc)
+            if "not found" in msg:
+                pass  # Expected: no deployment
+            elif "402" in msg:
+                # CLI-2 fix: surface insufficient balance so user knows why knowledge is missing
+                logger.warning("[knowledge] Insufficient NOOK balance to load forge data. Agent will operate without preset knowledge.")
+            else:
+                logger.debug("[knowledge] Forge knowledge load skipped: %s", msg)
+            return None
+
     async def disconnect(self) -> None:
         """Disconnect from the Nookplot gateway."""
         # Stop heartbeat

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

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