nookplot-runtime 0.5.131__tar.gz → 0.5.132__tar.gz

{nookplot_runtime-0.5.131 → nookplot_runtime-0.5.132}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nookplot-runtime
-Version: 0.5.131
+Version: 0.5.132
 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.131 → nookplot_runtime-0.5.132}/nookplot_runtime/client.py

@@ -6219,6 +6219,20 @@ class NookplotRuntime:
         self._heartbeat_interval = heartbeat_interval_ms / 1000.0
         self._rpc_url = rpc_url
 
+        # Fail fast on the surplus-without-key footgun (mirrors the TS runtime +
+        # CLI validateConfig). Surplus inference signs each x402 payment with the
+        # agent's OWN key, so an API-key-only agent would construct fine but raise
+        # a keyless SurplusError on the FIRST inference call — deep in the
+        # autonomous loop, easily mistaken for an outage. Per-call
+        # `inference_source` overrides are still validated at call time.
+        if inference_source == "surplus" and not private_key:
+            raise ValueError(
+                "NookplotRuntime: inference_source is 'surplus' but no private_key was "
+                "provided. Surplus pays per call in USDC via x402 and REQUIRES a local "
+                "signing key. Pass private_key, or set inference_source to 'platform' to "
+                "route inference through the gateway."
+            )
+
         self._http = _HttpClient(
             gateway_url,
             api_key,

{nookplot_runtime-0.5.131 → nookplot_runtime-0.5.132}/pyproject.toml

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

{nookplot_runtime-0.5.131 → nookplot_runtime-0.5.132}/tests/test_client.py

@@ -381,3 +381,37 @@ def test_inbox_message_parsing() -> None:
     assert msg.from_address == "0xAAA"
     assert msg.from_name == "Agent A"
     assert msg.read_at is None
+
+
+# ============================================================
+#  Constructor — surplus fail-fast guard
+# ============================================================
+# Mirrors the TS runtime + CLI validateConfig: inference_source="surplus"
+# REQUIRES a local signing key, else every inference call would raise a keyless
+# SurplusError deep in the autonomous loop (easily mistaken for an outage).
+# Fail fast at construction instead. The call-time keyless behavior is covered
+# in test_economy_surplus_branch.py (which builds _HttpClient directly, BELOW
+# this top-level guard — so per-call overrides still validate at call time).
+
+
+def test_surplus_without_private_key_raises() -> None:
+    """inference_source='surplus' + no private_key → ValueError at construction."""
+    with pytest.raises(ValueError, match="inference_source is 'surplus'"):
+        NookplotRuntime(GATEWAY_URL, API_KEY, inference_source="surplus")
+
+
+@pytest.mark.asyncio
+async def test_surplus_with_private_key_constructs() -> None:
+    """inference_source='surplus' WITH a private_key constructs fine."""
+    runtime = NookplotRuntime(
+        GATEWAY_URL, API_KEY, private_key="0x" + "ab" * 32, inference_source="surplus"
+    )
+    assert runtime._private_key is not None
+    await runtime._http.close()
+
+
+@pytest.mark.asyncio
+async def test_platform_without_private_key_constructs() -> None:
+    """Default/platform source needs no key (gateway-metered / read-only agent)."""
+    runtime = NookplotRuntime(GATEWAY_URL, API_KEY, inference_source="platform")
+    await runtime._http.close()