bridgenode-cli 0.1.10__tar.gz → 0.1.12__tar.gz

{bridgenode_cli-0.1.10 → bridgenode_cli-0.1.12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bridgenode-cli
-Version: 0.1.10
+Version: 0.1.12
 Summary: Agentic AI CLI with x402 (HTTP 402) pay-per-request on Solana USDC — no API keys.
 Author-email: BridgeNode <eli.BNx@proton.me>
 License-Expression: MIT-0
@@ -60,8 +60,11 @@ pip install bridgenode
 ## Usage
 
 ```bash
+# Free models need no wallet — and the first 2 calls to a PAID model are free
+bridgenode chat "Hello!" --model gpt-oss-120b
+
 # Single chat completion (payment handshake fully automatic)
-bridgenode chat "Hello!" --model deepseek-v4-flash
+bridgenode chat "Hello!" --model deepseek-flash
 
 # Smart routing: auto / eco / premium
 bridgenode chat "Analyze this code" --mode auto
@@ -83,7 +86,8 @@ bridgenode models
 ## Configuration (.env)
 
 ```bash
-# Required — your Solana wallet private key (base58)
+# Optional — your Solana wallet private key (base58).
+# Needed only for PAID requests: free models and the 2 free trials work without it.
 BRIDGENODE_WALLET_KEY=...
 # Optional: BRIDGENODE_BASE_URL, BRIDGENODE_MAX_PER_CALL, BRIDGENODE_DAILY_CAP
 ```

{bridgenode_cli-0.1.10 → bridgenode_cli-0.1.12}/README.md

@@ -24,8 +24,11 @@ pip install bridgenode
 ## Usage
 
 ```bash
+# Free models need no wallet — and the first 2 calls to a PAID model are free
+bridgenode chat "Hello!" --model gpt-oss-120b
+
 # Single chat completion (payment handshake fully automatic)
-bridgenode chat "Hello!" --model deepseek-v4-flash
+bridgenode chat "Hello!" --model deepseek-flash
 
 # Smart routing: auto / eco / premium
 bridgenode chat "Analyze this code" --mode auto
@@ -47,7 +50,8 @@ bridgenode models
 ## Configuration (.env)
 
 ```bash
-# Required — your Solana wallet private key (base58)
+# Optional — your Solana wallet private key (base58).
+# Needed only for PAID requests: free models and the 2 free trials work without it.
 BRIDGENODE_WALLET_KEY=...
 # Optional: BRIDGENODE_BASE_URL, BRIDGENODE_MAX_PER_CALL, BRIDGENODE_DAILY_CAP
 ```

bridgenode_cli-0.1.12/bridgenode_cli/__init__.py

@@ -0,0 +1,6 @@
+"""bridgenode_cli — BridgeNode CLI."""
+
+from .main import main
+
+__all__ = ["main"]
+__version__ = "0.1.12"

{bridgenode_cli-0.1.10 → bridgenode_cli-0.1.12}/bridgenode_cli/__main__.py

@@ -1,4 +1,4 @@
-"""__main__.py — `python -m bridgenode_cli` entry point (R18/Ž18)."""
+"""__main__.py — `python -m bridgenode_cli` entry point."""
 
 import sys
 

{bridgenode_cli-0.1.10 → bridgenode_cli-0.1.12}/bridgenode_cli/main.py

@@ -1,13 +1,13 @@
-"""main.py — bridgenode CLI (§8.4, fix.md 4.4 step 1).
+"""main.py — bridgenode CLI.
 
 Commands:
 - `bridgenode chat "<prompt>"` — single chat completion via the x402 handshake
-  (SDK: 402 → partial TX → PAYMENT-SIGNATURE → 200; §4.1)
-- `bridgenode models` — model list + prices from GET /v1/models (§5.2)
+  (SDK: 402 → partial TX → PAYMENT-SIGNATURE → 200)
+- `bridgenode models` — model list + prices from GET /v1/models
 
-Options: --model (explicit, §5.1), --mode auto/eco/premium (smart routing,
-§5.1/§5.8), --max-tokens. All payment is hidden — uses the official
-LLMClient (P4). Errors → stderr + exit 1; success → stdout + exit 0.
+Options: --model (explicit), --mode auto/eco/premium (smart routing),
+--max-tokens. All payment is hidden — uses the official
+LLMClient. Errors → stderr + exit 1; success → stdout + exit 0.
 """
 
 from __future__ import annotations
@@ -21,9 +21,9 @@ from bridgenode_llm import BridgenodeError, LLMClient
 
 
 def _client(args: argparse.Namespace) -> LLMClient:
-    """LLMClient from CLI arguments (key ONLY from .env, §8.4)."""
-    # None values are not passed — the SDK uses defaults (§8.5);
-    # otherwise timeout=None would enter the flow timeout calculation (item 42)
+    """LLMClient from CLI arguments (key ONLY from .env)."""
+    # None values are not passed — the SDK uses defaults;
+    # otherwise timeout=None would enter the flow timeout calculation
     kwargs: dict[str, Any] = {}
     if args.base_url:
         kwargs["base_url"] = args.base_url
@@ -58,10 +58,10 @@ def cmd_chat(args: argparse.Namespace) -> int:
 
 
 def cmd_models(args: argparse.Namespace) -> int:
-    """`bridgenode models` — model list + prices (§5.2).
+    """`bridgenode models` — model list + prices.
 
     Public endpoint (no payment) — direct HTTP, without the SDK (the SDK has
-    only chat(), protocol §8.4)."""
+    only chat())."""
     import httpx
 
     base_url = (args.base_url or os.environ.get("BRIDGENODE_BASE_URL")
@@ -96,26 +96,26 @@ def build_parser() -> argparse.ArgumentParser:
     parser.add_argument("--base-url", default=None,
                         help="Base URL (default: BRIDGENODE_BASE_URL / https://bridgenode.cc/v1)")
     parser.add_argument("--initial-timeout", type=float, default=None,
-                        help="Initial request timeout s (queue until 402, §5.7)")
+                        help="Initial request timeout s (queue until 402)")
     parser.add_argument("--retry-timeout", type=float, default=None,
-                        help="Retry timeout s (≤115s budget, §4.3)")
+                        help="Retry timeout s (≤115s budget)")
     parser.add_argument("--max-per-call", type=float, default=None,
                         help="Spending policy: max USD per call (step 2)")
     parser.add_argument("--daily-cap", type=float, default=None,
                         help="Spending policy: max USD per day (step 2)")
     sub = parser.add_subparsers(dest="command", required=True)
 
-    p_chat = sub.add_parser("chat", help="Single chat completion via x402 (§4.1)")
+    p_chat = sub.add_parser("chat", help="Single chat completion via x402")
     p_chat.add_argument("prompt", help="Prompt text")
     p_chat.add_argument("--model", default=None,
                         help="Explicit model id (see `bridgenode models`)")
     p_chat.add_argument("--mode", choices=["auto", "eco", "premium"], default=None,
-                        help="Smart routing profile (§5.1/§5.8)")
+                        help="Smart routing profile")
     p_chat.add_argument("--max-tokens", type=int, default=None,
-                        help="Max output tokens (billing upfront, §4.2)")
+                        help="Max output tokens (billing upfront)")
     p_chat.set_defaults(func=cmd_chat)
 
-    p_models = sub.add_parser("models", help="Model list + prices (§5.2)")
+    p_models = sub.add_parser("models", help="Model list + prices")
     p_models.set_defaults(func=cmd_models)
 
     return parser

{bridgenode_cli-0.1.10 → bridgenode_cli-0.1.12}/bridgenode_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bridgenode-cli
-Version: 0.1.10
+Version: 0.1.12
 Summary: Agentic AI CLI with x402 (HTTP 402) pay-per-request on Solana USDC — no API keys.
 Author-email: BridgeNode <eli.BNx@proton.me>
 License-Expression: MIT-0
@@ -60,8 +60,11 @@ pip install bridgenode
 ## Usage
 
 ```bash
+# Free models need no wallet — and the first 2 calls to a PAID model are free
+bridgenode chat "Hello!" --model gpt-oss-120b
+
 # Single chat completion (payment handshake fully automatic)
-bridgenode chat "Hello!" --model deepseek-v4-flash
+bridgenode chat "Hello!" --model deepseek-flash
 
 # Smart routing: auto / eco / premium
 bridgenode chat "Analyze this code" --mode auto
@@ -83,7 +86,8 @@ bridgenode models
 ## Configuration (.env)
 
 ```bash
-# Required — your Solana wallet private key (base58)
+# Optional — your Solana wallet private key (base58).
+# Needed only for PAID requests: free models and the 2 free trials work without it.
 BRIDGENODE_WALLET_KEY=...
 # Optional: BRIDGENODE_BASE_URL, BRIDGENODE_MAX_PER_CALL, BRIDGENODE_DAILY_CAP
 ```

{bridgenode_cli-0.1.10 → bridgenode_cli-0.1.12}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "bridgenode-cli"
-version = "0.1.10"
+version = "0.1.12"
 description = "Agentic AI CLI with x402 (HTTP 402) pay-per-request on Solana USDC — no API keys."
 readme = "README.md"
 requires-python = ">=3.11"

{bridgenode_cli-0.1.10 → bridgenode_cli-0.1.12}/tests/test_cli.py

@@ -1,4 +1,4 @@
-"""test_cli.py — bridgenode CLI tests (fix.md 4.4 z1).
+"""test_cli.py — bridgenode CLI tests.
 
 Checks command output and argument passing with a mocked LLMClient
 (no network, no payment). Full mock-402 path — 4.4 z2.
@@ -63,7 +63,7 @@ def test_chat_mode_passed(fake_client, capsys):
 
 
 def test_chat_model_and_mode(fake_client):
-    """§5.1: both are passed through — the server resolves the conflict (model wins)."""
+    """Both are passed through — the server resolves the conflict (model wins)."""
     rc = cli.main(["chat", "hi", "--model", "deepseek-v4-flash",
                    "--mode", "premium"])
     assert rc == 0
@@ -150,7 +150,7 @@ def test_client_kwargs_wired(monkeypatch):
     """CLI arguments → LLMClient kwargs (timeouts, spending policy).
 
     Global options (--base-url etc.) — BEFORE the subcommand (argparse).
-    Checked via `chat` (the models command does not use the SDK — direct HTTP, §5.2).
+    Checked via `chat` (the models command does not use the SDK — direct HTTP).
     """
     captured: dict = {}
 

{bridgenode_cli-0.1.10 → bridgenode_cli-0.1.12}/tests/test_cli_integration.py

@@ -1,4 +1,4 @@
-"""test_cli_integration.py — CLI → real SDK path with mock 402 (fix.md 4.4 z2).
+"""test_cli_integration.py — CLI → real SDK path with mock 402.
 
 Full x402 handshake through the real `bridgenode_llm` SDK: CLI `chat` → 402
 (PAYMENT-REQUIRED) → partial TX → PAYMENT-SIGNATURE → 200 + valid
@@ -180,12 +180,12 @@ def test_cli_chat_full_handshake(monkeypatch, _mock_http, capsys):
     assert len(seen) == 2
     assert seen[0]["has_payment"] is False
     assert seen[1]["has_payment"] is True
-    assert seen[0]["body"] == seen[1]["body"]  # price-bind (§4.1.1)
+    assert seen[0]["body"] == seen[1]["body"]  # price-bind
     assert seen[0]["body"]["model"] == "deepseek-v4-flash"
 
 
 def test_cli_chat_mode_auto(monkeypatch, _mock_http, capsys):
-    """CLI --mode auto → SDK mode is passed through (smart routing §5.1)."""
+    """CLI --mode auto → SDK mode is passed through (smart routing)."""
     fee_kp = Keypair()
     client_kp = Keypair()
     seen = _install_server(_mock_http, fee_kp, str(client_kp.pubkey()))
@@ -197,7 +197,7 @@ def test_cli_chat_mode_auto(monkeypatch, _mock_http, capsys):
     assert seen[0]["body"]["mode"] == "auto"
 
 
-def test_cli_chat_kvitas_verify_fail(monkeypatch, _mock_http, capsys):
+def test_cli_chat_receipt_verify_fail(monkeypatch, _mock_http, capsys):
     """Forged receipt → CLI error (exit 1) — Free-Riding protection works."""
     fee_kp = Keypair()
     client_kp = Keypair()
@@ -233,7 +233,7 @@ def test_cli_chat_kvitas_verify_fail(monkeypatch, _mock_http, capsys):
     assert "does not match our TX" in capsys.readouterr().err
 
 
-# ── models: without payment (§5.2) ───────────────────────────────────────────────
+# ── models: without payment ───────────────────────────────────────────────
 
 def test_cli_models_integration(monkeypatch, capsys):
     import httpx
@@ -249,7 +249,7 @@ def test_cli_models_integration(monkeypatch, capsys):
              "context_window": 131072, "max_output_tokens": 32768},
         ]})
 
-    # models — direct HTTP (no SDK, §5.2 public endpoint)
+    # models — direct HTTP (no SDK, public endpoint)
     monkeypatch.setattr(httpx, "get", fake_get)
     rc = cli.main(["--base-url", API_BASE, "models"])
     assert rc == 0

bridgenode_cli-0.1.10/bridgenode_cli/__init__.py

@@ -1,6 +0,0 @@
-"""bridgenode_cli — BridgeNode CLI (§8.4, fix.md 4.4)."""
-
-from .main import main
-
-__all__ = ["main"]
-__version__ = "0.1.10"