hypercli-cli 2026.3.18__tar.gz → 2026.3.22__tar.gz

{hypercli_cli-2026.3.18 → hypercli_cli-2026.3.22}/.gitignore

@@ -28,6 +28,9 @@ coverage
 .DS_Store
 *.pem
 
+# IDE
+.idea/
+
 # Debug
 npm-debug.log*
 yarn-debug.log*

{hypercli_cli-2026.3.18 → hypercli_cli-2026.3.22}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hypercli-cli
-Version: 2026.3.18
+Version: 2026.3.22
 Summary: CLI for HyperCLI - GPU orchestration and LLM API
 Project-URL: Homepage, https://hypercli.com
 Project-URL: Documentation, https://docs.hypercli.com
@@ -9,7 +9,7 @@ Author-email: HyperCLI <support@hypercli.com>
 License: MIT
 Requires-Python: >=3.10
 Requires-Dist: httpx>=0.27.0
-Requires-Dist: hypercli-sdk>=2026.3.18
+Requires-Dist: hypercli-sdk>=2026.3.22
 Requires-Dist: mutagen>=1.47.0
 Requires-Dist: pyyaml>=6.0
 Requires-Dist: rich>=14.2.0
@@ -19,11 +19,11 @@ Provides-Extra: all
 Requires-Dist: argon2-cffi>=25.0.0; extra == 'all'
 Requires-Dist: eth-account>=0.13.0; extra == 'all'
 Requires-Dist: faster-whisper>=1.1.0; extra == 'all'
-Requires-Dist: hypercli-sdk[comfyui]>=2026.3.18; extra == 'all'
+Requires-Dist: hypercli-sdk[comfyui]>=2026.3.22; extra == 'all'
 Requires-Dist: web3>=7.0.0; extra == 'all'
 Requires-Dist: x402[evm,httpx]>=2.0.0; extra == 'all'
 Provides-Extra: comfyui
-Requires-Dist: hypercli-sdk[comfyui]>=2026.3.18; extra == 'comfyui'
+Requires-Dist: hypercli-sdk[comfyui]>=2026.3.22; extra == 'comfyui'
 Provides-Extra: dev
 Requires-Dist: pytest>=8.0.0; extra == 'dev'
 Requires-Dist: ruff>=0.3.0; extra == 'dev'

hypercli_cli-2026.3.22/hypercli_cli/__init__.py

@@ -0,0 +1 @@
+__version__ = "2026.3.22"

{hypercli_cli-2026.3.18 → hypercli_cli-2026.3.22}/hypercli_cli/agent.py

@@ -353,7 +353,7 @@ def models(
     import httpx
 
     api_base = DEV_API_BASE if dev else PROD_API_BASE
-    key = os.getenv("HYPERCLAW_API_KEY")
+    key = os.getenv("HYPER_API_KEY")
     headers = {"Authorization": f"Bearer {key}"} if key else {}
 
     # Prefer OpenAI-compatible endpoint, then fallback to legacy.
@@ -374,7 +374,7 @@ def models(
     if payload is None:
         console.print(
             f"[red]❌ Failed to fetch models from {urls[0]} or {urls[1]} "
-            "(set HYPERCLAW_API_KEY if endpoint requires auth)[/red]"
+            "(set HYPER_API_KEY if endpoint requires auth)[/red]"
         )
         raise typer.Exit(1)
 
@@ -548,7 +548,7 @@ def _resolve_api_base(base_url: str | None = None, dev: bool = False) -> str:
     """Resolve API base from flag/env, then fall back to dev/prod defaults."""
     return (
         base_url
-        or os.environ.get("HYPERCLAW_API_BASE")
+        or os.environ.get("HYPER_API_BASE")
         or (DEV_INFERENCE_API_BASE if dev else PROD_INFERENCE_API_BASE)
     ).rstrip("/")
 
@@ -881,7 +881,7 @@ def config_cmd(
         help=f"Output format: {', '.join(FORMAT_CHOICES)}. Omit to show all.",
     ),
     key: str = typer.Option(None, "--key", "-k", help="API key (sk-...). Falls back to ~/.hypercli/agent-key.json"),
-    base_url: str = typer.Option(None, "--base-url", help="HyperClaw API base URL. Falls back to HYPERCLAW_API_BASE, then --dev/prod defaults"),
+    base_url: str = typer.Option(None, "--base-url", help="HyperClaw API base URL. Falls back to HYPER_API_BASE, then --dev/prod defaults"),
     placeholder_env: str = typer.Option(None, "--placeholder-env", help="Write ${ENV_VAR} placeholders into generated config instead of literal API keys"),
     apply: bool = typer.Option(False, "--apply", help="Write config to the appropriate file (openclaw/opencode only)"),
     dev: bool = typer.Option(False, "--dev", help="Use dev API"),

{hypercli_cli-2026.3.18 → hypercli_cli-2026.3.22}/hypercli_cli/agents.py

@@ -18,8 +18,6 @@ app = typer.Typer(help="Manage OpenClaw agent pods")
 console = Console()
 PROD_API_BASE = "https://api.hypercli.com"
 DEV_API_BASE = "https://api.dev.hypercli.com"
-PROD_AGENTS_WS_URL = "wss://api.agents.hypercli.com/ws"
-DEV_AGENTS_WS_URL = "wss://api.agents.dev.hypercli.com/ws"
 _GLOBAL_DEV = False
 _GLOBAL_AGENTS_WS_URL: str | None = None
 
@@ -49,7 +47,10 @@ def agents_root(
 
 def _get_agent_api_key() -> str:
     """Resolve HyperClaw API key from env or saved key file."""
-    key = os.environ.get("HYPERCLAW_API_KEY", "")
+    key = os.environ.get("HYPER_AGENTS_API_KEY", "").strip()
+    if key:
+        return key
+    key = os.environ.get("HYPER_API_KEY", "").strip()
     if key:
         return key
     if AGENT_KEY_PATH.exists():
@@ -59,7 +60,7 @@ def _get_agent_api_key() -> str:
         if key:
             return key
     console.print("[red]❌ No HyperClaw API key found.[/red]")
-    console.print("Set HYPERCLAW_API_KEY or subscribe: [bold]hyper agent subscribe 1aiu[/bold]")
+    console.print("Set HYPER_AGENTS_API_KEY or HYPER_API_KEY, or subscribe: [bold]hyper agent subscribe 1aiu[/bold]")
     raise typer.Exit(1)
 
 
@@ -67,12 +68,13 @@ def _get_deployments_client(agents_ws_url: str | None = None) -> Deployments:
     """Create a Deployments client using the HyperClaw API key."""
     from hypercli.http import HTTPClient
     api_key = _get_agent_api_key()
-    api_base = os.environ.get("HYPERCLI_API_URL") or (DEV_API_BASE if _GLOBAL_DEV else PROD_API_BASE)
+    api_base = (
+        os.environ.get("AGENTS_API_BASE_URL")
+        or os.environ.get("HYPER_API_BASE")
+        or os.environ.get("HYPERCLI_API_URL")
+        or (DEV_API_BASE if _GLOBAL_DEV else PROD_API_BASE)
+    )
     resolved_agents_ws_url = agents_ws_url or _GLOBAL_AGENTS_WS_URL or os.environ.get("AGENTS_WS_URL")
-    if _GLOBAL_DEV and not resolved_agents_ws_url:
-        resolved_agents_ws_url = DEV_AGENTS_WS_URL
-    if not _GLOBAL_DEV and not resolved_agents_ws_url and os.environ.get("HYPERCLI_API_URL", "").strip() == "":
-        resolved_agents_ws_url = PROD_AGENTS_WS_URL
     http = HTTPClient(api_base, api_key)
     return Deployments(http, api_key=api_key, api_base=api_base, agents_ws_url=resolved_agents_ws_url)
 
@@ -1015,6 +1017,8 @@ def gateway_chat(
                 console.print(f"[dim]{event.text}[/dim]", end="")
             elif event.type == "tool_call":
                 console.print(f"\n[yellow]🔧 {event.data}[/yellow]")
+            elif event.type == "tool_result":
+                console.print(f"\n[cyan]📤 {event.data}[/cyan]")
             elif event.type == "error":
                 console.print(f"\n[red]❌ {event.text}[/red]")
             elif event.type == "done":

{hypercli_cli-2026.3.18 → hypercli_cli-2026.3.22}/hypercli_cli/embed.py

@@ -17,10 +17,10 @@ DEV_API_BASE = "https://api.dev.hypercli.com"
 
 
 def _get_api_key(key: str | None) -> str:
-    """Resolve API key: --key flag > env HYPERCLAW_API_KEY > agent-key.json."""
+    """Resolve API key: --key flag > env HYPER_API_KEY > agent-key.json."""
     if key:
         return key
-    env_key = os.environ.get("HYPERCLAW_API_KEY", "").strip()
+    env_key = os.environ.get("HYPER_API_KEY", "").strip()
     if env_key:
         return env_key
     if AGENT_KEY_PATH.exists():
@@ -29,7 +29,7 @@ def _get_api_key(key: str | None) -> str:
         if k:
             return k
     console.print("[red]❌ No API key found.[/red]")
-    console.print("Pass [bold]--key sk-...[/bold], set [bold]HYPERCLAW_API_KEY[/bold], or run [bold]hyper agent subscribe[/bold]")
+    console.print("Pass [bold]--key sk-...[/bold], set [bold]HYPER_API_KEY[/bold], or run [bold]hyper agent subscribe[/bold]")
     raise typer.Exit(1)
 
 

{hypercli_cli-2026.3.18 → hypercli_cli-2026.3.22}/hypercli_cli/instances.py

@@ -11,6 +11,21 @@ def get_client() -> HyperCLI:
     return HyperCLI()
 
 
+def _parse_constraints(
+    constraints: Optional[list[str]],
+    cpu_vendor: Optional[str],
+) -> dict[str, str] | None:
+    parsed: dict[str, str] = {}
+    for item in constraints or []:
+        key, sep, value = item.partition("=")
+        if not sep or not key or not value:
+            raise typer.BadParameter(f"Invalid constraint '{item}', expected KEY=VALUE")
+        parsed[key.strip()] = value.strip()
+    if cpu_vendor:
+        parsed.setdefault("cpu_vendor", cpu_vendor.strip())
+    return parsed or None
+
+
 @app.command("list")
 def list_instances(
     gpu: Optional[str] = typer.Option(None, "--gpu", "-g", help="Filter by GPU type"),
@@ -64,7 +79,13 @@ def list_gpus(
 
     if fmt == "json":
         output({k: {"name": v.name, "description": v.description, "configs": [
-            {"gpu_count": c.gpu_count, "cpu_cores": c.cpu_cores, "memory_gb": c.memory_gb, "regions": c.regions}
+            {
+                "gpu_count": c.gpu_count,
+                "cpu_cores": c.cpu_cores,
+                "memory_gb": c.memory_gb,
+                "regions": c.regions,
+                "constraints": c.constraints,
+            }
             for c in v.configs
         ]} for k, v in types.items()}, "json")
     else:
@@ -187,6 +208,8 @@ def launch(
     gpu: str = typer.Option("l40s", "--gpu", "-g", help="GPU type"),
     count: int = typer.Option(1, "--count", "-n", help="Number of GPUs"),
     region: Optional[str] = typer.Option(None, "--region", "-r", help="Region code"),
+    constraint: Optional[list[str]] = typer.Option(None, "--constraint", help="Placement constraint KEY=VALUE (repeatable)"),
+    cpu_vendor: Optional[str] = typer.Option(None, "--cpu-vendor", help="CPU vendor constraint (e.g. intel, amd)"),
     runtime: Optional[int] = typer.Option(None, "--runtime", "-t", help="Runtime in seconds"),
     interruptible: bool = typer.Option(True, "--interruptible/--on-demand", help="Use interruptible instances"),
     env: Optional[list[str]] = typer.Option(None, "--env", "-e", help="Env vars (KEY=VALUE)"),
@@ -256,6 +279,8 @@ def launch(
     if command and any(op in command for op in ["&&", "||", "|", ";", ">", "<", "$"]):
         command = f'sh -c "{command}"'
 
+    constraints = _parse_constraints(constraint, cpu_vendor)
+
     follow_api_key = None
 
     if x402:
@@ -281,6 +306,7 @@ def launch(
                 gpu_type=gpu,
                 gpu_count=count,
                 region=region,
+                constraints=constraints,
                 interruptible=interruptible,
                 env=env_dict,
                 ports=ports_dict,
@@ -330,6 +356,7 @@ def launch(
                 gpu_type=gpu,
                 gpu_count=count,
                 region=region,
+                constraints=constraints,
                 runtime=runtime,
                 interruptible=interruptible,
                 env=env_dict,

{hypercli_cli-2026.3.18 → hypercli_cli-2026.3.22}/hypercli_cli/voice.py

@@ -18,10 +18,13 @@ DEFAULT_API_BASE = "https://api.hypercli.com"
 
 
 def _get_api_key(key: str | None) -> str:
-    """Resolve API key: --key flag > env HYPERCLAW_API_KEY > agent-key.json."""
+    """Resolve API key: --key > HYPER_API_KEY > HYPER_AGENTS_API_KEY > agent-key.json."""
     if key:
         return key
-    env_key = os.environ.get("HYPERCLAW_API_KEY", "").strip()
+    env_key = os.environ.get("HYPER_API_KEY", "").strip()
+    if env_key:
+        return env_key
+    env_key = os.environ.get("HYPER_AGENTS_API_KEY", "").strip()
     if env_key:
         return env_key
     if AGENT_KEY_PATH.exists():
@@ -30,15 +33,18 @@ def _get_api_key(key: str | None) -> str:
         if k:
             return k
     console.print("[red]❌ No API key found.[/red]")
-    console.print("Pass [bold]--key sk-...[/bold], set [bold]HYPERCLAW_API_KEY[/bold], or run [bold]hyper agent subscribe[/bold]")
+    console.print("Pass [bold]--key sk-...[/bold], set [bold]HYPER_API_KEY[/bold] or [bold]HYPER_AGENTS_API_KEY[/bold], or run [bold]hyper agent subscribe[/bold]")
     raise typer.Exit(1)
 
 
 def _resolve_api_base(base_url: str | None) -> str:
-    """Resolve API base: --base-url > HYPERCLAW_API_BASE env > default."""
+    """Resolve API base: --base-url > HYPER_API_BASE > HYPERCLI_API_URL > default."""
     if base_url:
         return base_url.rstrip("/")
-    env_base = os.environ.get("HYPERCLAW_API_BASE", "").strip()
+    env_base = os.environ.get("HYPER_API_BASE", "").strip()
+    if env_base:
+        return env_base.rstrip("/")
+    env_base = os.environ.get("HYPERCLI_API_URL", "").strip()
     if env_base:
         return env_base.rstrip("/")
     return DEFAULT_API_BASE

{hypercli_cli-2026.3.18 → hypercli_cli-2026.3.22}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "hypercli-cli"
-version = "2026.3.18"
+version = "2026.3.22"
 description = "CLI for HyperCLI - GPU orchestration and LLM API"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -13,7 +13,7 @@ authors = [
     { name = "HyperCLI", email = "support@hypercli.com" }
 ]
 dependencies = [
-    "hypercli-sdk>=2026.3.18",
+    "hypercli-sdk>=2026.3.22",
     "typer>=0.20.0",
     "rich>=14.2.0",
     "websocket-client>=1.6.0",
@@ -24,7 +24,7 @@ dependencies = [
 
 [project.optional-dependencies]
 comfyui = [
-    "hypercli-sdk[comfyui]>=2026.3.18",
+    "hypercli-sdk[comfyui]>=2026.3.22",
 ]
 wallet = [
     "x402[httpx,evm]>=2.0.0",
@@ -37,7 +37,7 @@ stt = [
     "faster-whisper>=1.1.0",
 ]
 all = [
-    "hypercli-sdk[comfyui]>=2026.3.18",
+    "hypercli-sdk[comfyui]>=2026.3.22",
     "x402[httpx,evm]>=2.0.0",
     "eth-account>=0.13.0",
     "web3>=7.0.0",

hypercli_cli-2026.3.22/tests/test_agent_env_resolution.py

@@ -0,0 +1,39 @@
+import importlib
+
+
+def test_agents_cli_prefers_agent_key_env(monkeypatch):
+    monkeypatch.setenv("HYPER_API_KEY", "sk-product")
+    monkeypatch.setenv("HYPER_AGENTS_API_KEY", "sk-agent")
+
+    import hypercli_cli.agents as agents
+
+    importlib.reload(agents)
+
+    assert agents._get_agent_api_key() == "sk-agent"
+
+
+def test_agents_cli_prefers_agent_base_env(monkeypatch):
+    monkeypatch.setenv("AGENTS_API_BASE_URL", "https://api.agents.dev.hypercli.com")
+    monkeypatch.setenv("AGENTS_WS_URL", "wss://api.agents.dev.hypercli.com/ws")
+    monkeypatch.setenv("HYPER_AGENTS_API_KEY", "sk-agent")
+
+    import hypercli_cli.agents as agents
+
+    importlib.reload(agents)
+
+    client = agents._get_deployments_client()
+    assert client._api_base == "https://api.dev.hypercli.com/agents"
+
+
+def test_voice_cli_prefers_product_envs(monkeypatch):
+    monkeypatch.setenv("HYPER_API_KEY", "sk-product")
+    monkeypatch.setenv("HYPER_AGENTS_API_KEY", "sk-agent")
+    monkeypatch.setenv("HYPER_API_BASE", "https://api.hypercli.com")
+    monkeypatch.setenv("HYPERCLI_API_URL", "https://api.dev.hypercli.com")
+
+    import hypercli_cli.voice as voice
+
+    importlib.reload(voice)
+
+    assert voice._get_api_key(None) == "sk-product"
+    assert voice._resolve_api_base(None) == "https://api.hypercli.com"

{hypercli_cli-2026.3.18 → hypercli_cli-2026.3.22}/tests/test_exec_shell_dryrun.py

@@ -98,6 +98,52 @@ def test_instances_launch_dry_run_mock(monkeypatch):
     assert "job-dryrun" in result.stdout
 
 
+def test_instances_launch_dry_run_includes_constraints(monkeypatch):
+    captured = {}
+
+    class FakeJobs:
+        def create(self, **kwargs):
+            captured.update(kwargs)
+            return SimpleNamespace(
+                job_id="job-dryrun",
+                state="validated",
+                gpu_type="h200",
+                gpu_count=8,
+                region="br",
+                constraints={"cpu_vendor": "amd"},
+                price_per_hour=12.34,
+                runtime=300,
+                cold_boot=False,
+                hostname=None,
+            )
+
+    fake_client = SimpleNamespace(jobs=FakeJobs())
+    monkeypatch.setattr("hypercli_cli.instances.get_client", lambda: fake_client)
+
+    result = runner.invoke(
+        app,
+        [
+            "instances",
+            "launch",
+            "nvidia/cuda:12.0-base-ubuntu22.04",
+            "--dry-run",
+            "--gpu",
+            "h200",
+            "--count",
+            "8",
+            "--cpu-vendor",
+            "amd",
+            "--constraint",
+            "stack=prod",
+            "--output",
+            "json",
+        ],
+    )
+
+    assert result.exit_code == 0
+    assert captured["constraints"] == {"cpu_vendor": "amd", "stack": "prod"}
+
+
 def test_agent_exec_command(monkeypatch):
     called = {}
 

{hypercli_cli-2026.3.18 → hypercli_cli-2026.3.22}/tests/test_openclaw_config.py

@@ -54,10 +54,10 @@ def test_config_openclaw_supports_placeholder_api_key_env():
             {"id": "qwen3-embedding-4b", "name": "Qwen3 Embedding 4B", "mode": "embedding"},
         ],
         "https://api.agents.hypercli.com",
-        placeholder_env="HYPER_AGENTS_API_KEY",
+        placeholder_env="HYPER_API_KEY",
     )
 
     providers = config["models"]["providers"]
-    assert providers["hyperclaw"]["apiKey"] == "${HYPER_AGENTS_API_KEY}"
-    assert providers["kimi-coding"]["apiKey"] == "${HYPER_AGENTS_API_KEY}"
-    assert config["agents"]["defaults"]["memorySearch"]["remote"]["apiKey"] == "${HYPER_AGENTS_API_KEY}"
+    assert providers["hyperclaw"]["apiKey"] == "${HYPER_API_KEY}"
+    assert providers["kimi-coding"]["apiKey"] == "${HYPER_API_KEY}"
+    assert config["agents"]["defaults"]["memorySearch"]["remote"]["apiKey"] == "${HYPER_API_KEY}"

hypercli_cli-2026.3.18/hypercli_cli/__init__.py

@@ -1 +0,0 @@
-__version__ = "2026.3.18"