hypercli-cli 2026.5.5__tar.gz → 2026.6.16__tar.gz

{hypercli_cli-2026.5.5 → hypercli_cli-2026.6.16}/.gitignore

@@ -26,6 +26,7 @@ coverage
 
 # Misc
 .DS_Store
+.agents/
 *.pem
 
 # IDE

{hypercli_cli-2026.5.5 → hypercli_cli-2026.6.16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hypercli-cli
-Version: 2026.5.5
+Version: 2026.6.16
 Summary: CLI for HyperCLI - GPU orchestration and LLM API
 Project-URL: Homepage, https://hypercli.com
 Project-URL: Documentation, https://docs.hypercli.com
@@ -9,22 +9,22 @@ Author-email: HyperCLI <support@hypercli.com>
 License: MIT
 Requires-Python: >=3.10
 Requires-Dist: httpx>=0.27.0
-Requires-Dist: hypercli-sdk>=2026.5.5
+Requires-Dist: hypercli-sdk>=2026.6.16
 Requires-Dist: mutagen>=1.47.0
 Requires-Dist: openai>=2.8.1
+Requires-Dist: pysubs2>=1.8.0
 Requires-Dist: pyyaml>=6.0
 Requires-Dist: rich>=14.2.0
 Requires-Dist: typer>=0.20.0
-Requires-Dist: websocket-client>=1.6.0
 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.5.5; extra == 'all'
+Requires-Dist: hypercli-sdk[comfyui]>=2026.6.16; 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.5.5; extra == 'comfyui'
+Requires-Dist: hypercli-sdk[comfyui]>=2026.6.16; extra == 'comfyui'
 Provides-Extra: dev
 Requires-Dist: pytest>=8.0.0; extra == 'dev'
 Requires-Dist: ruff>=0.3.0; extra == 'dev'

hypercli_cli-2026.6.16/hypercli_cli/__init__.py

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

{hypercli_cli-2026.5.5 → hypercli_cli-2026.6.16}/hypercli_cli/agent.py

@@ -12,7 +12,7 @@ from rich.console import Console
 from rich.table import Table
 
 from hypercli import HyperCLI
-from hypercli.config import get_agents_api_base_url_from_product_base
+from hypercli.config import get_agent_api_key, get_agents_api_base_url_from_product_base
 
 from .onboard import onboard as _onboard_fn
 from .voice import app as voice_app
@@ -54,7 +54,7 @@ def require_x402_deps():
 
 
 def _resolve_agent_query_key() -> str:
-    key = os.getenv("HYPER_AGENTS_API_KEY", "").strip() or os.getenv("HYPER_API_KEY", "").strip()
+    key = (get_agent_api_key() or "").strip()
     if key:
         return key
     if AGENT_KEY_PATH.exists():
@@ -749,7 +749,21 @@ def fetch_models(api_key: str, api_base: str = PROD_INFERENCE_API_BASE) -> list[
         normalized = (model_id or "").strip().lower()
         aliases = {
             "kimi-k2.5": {"name": "Kimi K2.5", "reasoning": True, "contextWindow": 262144},
+            "kimi-k2.5-anthropic": {"name": "Kimi K2.5 Anthropic", "reasoning": True, "contextWindow": 262144},
+            "kimi-k2.6": {"name": "Kimi K2.6", "reasoning": True, "contextWindow": 262144},
+            "kimi-k2.6-anthropic": {"name": "Kimi K2.6 Anthropic", "reasoning": True, "contextWindow": 262144},
             "moonshotai/kimi-k2.5": {"name": "Kimi K2.5", "reasoning": True, "contextWindow": 262144},
+            "moonshotai/kimi-k2.5-anthropic": {
+                "name": "Kimi K2.5 Anthropic",
+                "reasoning": True,
+                "contextWindow": 262144,
+            },
+            "moonshotai/kimi-k2.6": {"name": "Kimi K2.6", "reasoning": True, "contextWindow": 262144},
+            "moonshotai/kimi-k2.6-anthropic": {
+                "name": "Kimi K2.6 Anthropic",
+                "reasoning": True,
+                "contextWindow": 262144,
+            },
             "glm-5": {"name": "GLM-5", "reasoning": True, "contextWindow": 202752},
             "zai-org/glm-5": {"name": "GLM-5", "reasoning": True, "contextWindow": 202752},
             "qwen3-embedding-4b": {
@@ -814,9 +828,21 @@ def fetch_models(api_key: str, api_base: str = PROD_INFERENCE_API_BASE) -> list[
         ]
 
 
+def _preferred_agent_models(models: list[dict]) -> list[dict]:
+    """Return the recommended agent models in priority order."""
+    preferred = ["kimi-k2.6-anthropic", "kimi-k2.5-anthropic"]
+    picked = [model for model_id in preferred for model in models if model["id"] == model_id]
+    if picked:
+        return picked
+    anthropic = [model for model in models if model["id"].endswith("-anthropic")]
+    if anthropic:
+        return anthropic
+    return models[:1]
+
+
 @app.command("openclaw-setup")
 def openclaw_setup(
-    default: bool = typer.Option(False, "--default", help="Set hyperclaw/kimi-k2.5 as the default model"),
+    default: bool = typer.Option(False, "--default", help="Set hyperclaw/kimi-k2.6-anthropic as the default model"),
 ):
     """Patch OpenClaw config with your HyperClaw API key.
 
@@ -912,8 +938,8 @@ def _config_openclaw(
 
     api_base = api_base.rstrip("/")
     supported_models = [m for m in models if _is_supported_openclaw_model(m)]
-    chat_models = [m for m in supported_models if m.get("mode") != "embedding"]
     embedding_models = [m for m in supported_models if m.get("mode") == "embedding"]
+    chat_models = _preferred_agent_models([m for m in supported_models if m.get("mode") != "embedding"])
     kimi_models = [m for m in chat_models if "kimi" in _model_suffix(m.get("id", ""))]
     glm_models = [m for m in chat_models if _model_suffix(m.get("id", "")) == "glm-5"]
     other_chat_models = [
@@ -974,6 +1000,7 @@ def _config_openclaw(
 def _config_opencode(api_key: str, models: list[dict], api_base: str = PROD_INFERENCE_API_BASE) -> dict:
     """OpenCode opencode.json provider snippet."""
     api_base = api_base.rstrip("/")
+    models = _preferred_agent_models(models)
     model_entries = {}
     for m in models:
         model_entries[m["id"]] = {"name": m["id"]}
@@ -981,7 +1008,7 @@ def _config_opencode(api_key: str, models: list[dict], api_base: str = PROD_INFE
         "$schema": "https://opencode.ai/config.json",
         "provider": {
             "hypercli": {
-                "npm": "@ai-sdk/openai-compatible",
+                "npm": "@ai-sdk/anthropic",
                 "name": "HyperCLI",
                 "options": {
                     "baseURL": f"{api_base}/v1",
@@ -989,13 +1016,15 @@ def _config_opencode(api_key: str, models: list[dict], api_base: str = PROD_INFE
                 },
                 "models": model_entries,
             }
-        }
+        },
+        "model": f"hypercli/{models[0]['id']}",
     }
 
 
 def _config_env(api_key: str, models: list[dict], api_base: str = PROD_INFERENCE_API_BASE) -> str:
     """Shell env vars for generic OpenAI-compatible tools."""
     api_base = api_base.rstrip("/")
+    models = _preferred_agent_models(models)
     lines = [
         f'export OPENAI_API_KEY="{api_key}"',
         f'export OPENAI_BASE_URL="{api_base}/v1"',

{hypercli_cli-2026.5.5 → hypercli_cli-2026.6.16}/hypercli_cli/agents.py

@@ -12,7 +12,8 @@ import typer
 from rich.console import Console
 from rich.table import Table
 
-from hypercli.agents import Agent, Deployments, OpenClawAgent, DEFAULT_OPENCLAW_IMAGE
+from hypercli.agents import AGENT_FILE_MAX_BYTES, Agent, Deployments, OpenClawAgent, DEFAULT_OPENCLAW_IMAGE
+from hypercli.config import get_agent_api_key as get_config_agent_api_key
 
 app = typer.Typer(help="Manage OpenClaw agent pods")
 console = Console()
@@ -46,11 +47,8 @@ def agents_root(
 
 
 def _get_agent_api_key() -> str:
-    """Resolve HyperClaw API key from env or saved key file."""
-    key = os.environ.get("HYPER_AGENTS_API_KEY", "").strip()
-    if key:
-        return key
-    key = os.environ.get("HYPER_API_KEY", "").strip()
+    """Resolve HyperClaw API key from canonical config before legacy key file."""
+    key = (get_config_agent_api_key() or "").strip()
     if key:
         return key
     if AGENT_KEY_PATH.exists():
@@ -286,6 +284,8 @@ def create(
     registry_url: str = typer.Option(None, "--registry-url", help="Container registry URL for private image pulls"),
     registry_username: str = typer.Option(None, "--registry-username", help="Registry username"),
     registry_password: str = typer.Option(None, "--registry-password", help="Registry password"),
+    sync_uid: int = typer.Option(None, "--sync-uid", help="UID for restored synced files; defaults to Lagoon's configured value"),
+    sync_gid: int = typer.Option(None, "--sync-gid", help="GID for restored synced files; defaults to Lagoon's configured value"),
     gateway_token: str = typer.Option(None, "--gateway-token", help="OpenClaw gateway token override"),
     dry_run: bool = typer.Option(False, "--dry-run", help="Validate launch configuration without creating the agent or pod"),
     no_start: bool = typer.Option(False, "--no-start", help="Create without starting"),
@@ -312,6 +312,8 @@ def create(
             image=_default_openclaw_image(image),
             registry_url=registry_url,
             registry_auth=registry_auth,
+            sync_uid=sync_uid,
+            sync_gid=sync_gid,
             gateway_token=gateway_token,
             dry_run=dry_run,
             start=not no_start,
@@ -438,6 +440,36 @@ def list_agents(
 
     console.print()
     console.print(table)
+
+
+@app.command("web-search")
+def web_search_cmd(
+    query: str = typer.Argument(..., help="Search query"),
+    count: int = typer.Option(5, "--count", "-n", min=1, max=20, help="Number of Brave results to request"),
+    json_output: bool = typer.Option(False, "--json", help="Print raw JSON response"),
+):
+    """Search the web through the HyperClaw Brave proxy."""
+    agents = _get_deployments_client()
+    try:
+        payload = agents.web_search(query, count=count)
+    except Exception as e:
+        console.print(f"[red]❌ Web search failed: {e}[/red]")
+        raise typer.Exit(1)
+
+    if json_output:
+        console.print(json.dumps(payload, indent=2))
+        return
+
+    web = payload.get("web") if isinstance(payload, dict) else None
+    results = web.get("results") if isinstance(web, dict) else []
+    table = Table(title="Web Search")
+    table.add_column("Title")
+    table.add_column("URL")
+    for item in results or []:
+        if not isinstance(item, dict):
+            continue
+        table.add_row(str(item.get("title") or ""), str(item.get("url") or ""))
+    console.print(table)
     console.print()
 
 
@@ -495,6 +527,8 @@ def start(
     registry_url: str = typer.Option(None, "--registry-url", help="Container registry URL for private image pulls"),
     registry_username: str = typer.Option(None, "--registry-username", help="Registry username"),
     registry_password: str = typer.Option(None, "--registry-password", help="Registry password"),
+    sync_uid: int = typer.Option(None, "--sync-uid", help="UID for restored synced files; defaults to Lagoon's configured value"),
+    sync_gid: int = typer.Option(None, "--sync-gid", help="GID for restored synced files; defaults to Lagoon's configured value"),
     gateway_token: str = typer.Option(None, "--gateway-token", help="OpenClaw gateway token override"),
     dry_run: bool = typer.Option(False, "--dry-run", help="Validate launch configuration without starting the agent"),
 ):
@@ -523,6 +557,8 @@ def start(
             image=effective_image,
             registry_url=registry_url,
             registry_auth=registry_auth,
+            sync_uid=sync_uid,
+            sync_gid=sync_gid,
             gateway_token=effective_gateway_token,
             dry_run=dry_run,
         )
@@ -641,6 +677,9 @@ def cp(
 
     try:
         if dst_agent_id:
+            local_size = Path(src_path).stat().st_size
+            if local_size > AGENT_FILE_MAX_BYTES:
+                raise ValueError(f"Agent file writes are limited to {AGENT_FILE_MAX_BYTES // 1024 // 1024} MiB")
             pod = _get_pod_with_token(dst_agent_id)
             agents.cp_to(pod, src_path, dst_path)
             console.print(f"[green]✓[/green] Copied [bold]{src_path}[/bold] to [bold]{dst_agent_id[:12]}:{dst_path}[/bold]")

{hypercli_cli-2026.5.5 → hypercli_cli-2026.6.16}/hypercli_cli/cli.py

@@ -1,6 +1,7 @@
 """HyperCLI - Main entry point"""
 import sys
 import json
+from datetime import datetime, timezone
 import typer
 from rich.console import Console
 from rich.prompt import Prompt
@@ -9,12 +10,30 @@ from rich.table import Table
 from hypercli import HyperCLI, APIError, configure
 from hypercli.config import CONFIG_FILE
 
-from . import agent, agents, billing, comfyui, files, flow, instances, jobs, keys, llm, user, voice, wallet
+from . import agent, agents, billing, comfyui, files, flow, instances, jobs, keys, llm, memory, user, voice, wallet
 from .output import output, spinner
 
 console = Console()
 
 
+def _format_time_left(expires_at: datetime | None) -> str:
+    if not expires_at:
+        return ""
+    if expires_at.tzinfo is None:
+        expires_at = expires_at.replace(tzinfo=timezone.utc)
+    remaining = expires_at - datetime.now(timezone.utc)
+    if remaining.total_seconds() <= 0:
+        return "expired"
+    days = remaining.days
+    hours = remaining.seconds // 3600
+    minutes = (remaining.seconds % 3600) // 60
+    if days:
+        return f"{days}d {hours}h"
+    if hours:
+        return f"{hours}h {minutes}m"
+    return f"{minutes}m"
+
+
 def fuzzy_match(input_str: str, options: list[str], threshold: float = 0.5) -> list[str]:
     """Find similar strings using multiple heuristics"""
     def similarity(a: str, b: str) -> float:
@@ -75,6 +94,7 @@ app.add_typer(instances.app, name="instances")
 app.add_typer(keys.app, name="keys")
 app.add_typer(jobs.app, name="jobs")
 app.add_typer(llm.app, name="llm")
+app.add_typer(memory.app, name="memory")
 app.add_typer(user.app, name="user")
 app.add_typer(voice.app, name="voice")
 app.add_typer(wallet.app, name="wallet")
@@ -107,8 +127,32 @@ def me_cmd(
     client = HyperCLI()
     with spinner("Resolving auth context..."):
         auth_me = client.user.auth_me()
+        entitlement_summary = None
+        entitlement_error = None
+        try:
+            entitlement_summary = client.agent.subscription_summary()
+        except APIError as exc:
+            entitlement_error = f"{exc.status_code}: {exc.detail}"
+        except Exception as exc:
+            entitlement_error = str(exc)
     if fmt == "json":
-        output(auth_me, fmt)
+        payload = dict(getattr(auth_me, "__dict__", {}))
+        if entitlement_summary is not None:
+            payload["agents_entitlements"] = {
+                "effective_plan_id": entitlement_summary.effective_plan_id,
+                "current_subscription_id": entitlement_summary.current_subscription_id,
+                "current_entitlement_id": entitlement_summary.current_entitlement_id,
+                "active_subscription_count": entitlement_summary.active_subscription_count,
+                "active_entitlement_count": entitlement_summary.active_entitlement_count,
+                "pooled_tpm_limit": entitlement_summary.pooled_tpm_limit,
+                "pooled_rpm_limit": entitlement_summary.pooled_rpm_limit,
+                "pooled_tpd": entitlement_summary.pooled_tpd,
+                "billing_reset_at": entitlement_summary.billing_reset_at,
+                "entitlement_items": [item.__dict__ for item in entitlement_summary.entitlement_items],
+            }
+        elif entitlement_error:
+            payload["agents_entitlements_error"] = entitlement_error
+        output(payload, fmt)
         return
 
     table = Table(show_header=False, box=None)
@@ -127,6 +171,51 @@ def me_cmd(
     raw_capabilities = list(getattr(auth_me, "capabilities", []) or [])
     capabilities = "\n".join(raw_capabilities) if raw_capabilities else ""
     table.add_row("capabilities", capabilities)
+    if entitlement_summary is not None:
+        table.add_row("agents_effective_plan", entitlement_summary.effective_plan_id)
+        table.add_row("agents_current_entitlement", str(entitlement_summary.current_entitlement_id or ""))
+        table.add_row("agents_active_entitlements", str(entitlement_summary.active_entitlement_count))
+        active_items = [item for item in entitlement_summary.entitlement_items if str(item.status).upper() == "ACTIVE"]
+        expires_at = max((item.expires_at for item in active_items if item.expires_at), default=None)
+        if expires_at:
+            table.add_row("agents_expires_at", expires_at.isoformat())
+            table.add_row("agents_time_left", _format_time_left(expires_at))
+        table.add_row(
+            "agents_limits",
+            (
+                f"{entitlement_summary.pooled_tpm_limit:,} TPM / "
+                f"{entitlement_summary.pooled_rpm_limit:,} RPM / "
+                f"{entitlement_summary.pooled_tpd:,} TPD"
+            ),
+        )
+    elif entitlement_error:
+        table.add_row("agents_entitlements", f"unavailable ({entitlement_error})")
+    console.print(table)
+
+
+@app.command("status")
+def status_cmd(
+    fmt: str = typer.Option("table", "--output", "-o", help="Output format: table|json"),
+):
+    """Show compact platform status."""
+    client = HyperCLI()
+    with spinner("Checking platform status..."):
+        payload = client.status()
+    if fmt == "json":
+        output(payload, fmt)
+        return
+
+    table = Table(show_header=True, header_style="bold cyan")
+    table.add_column("Type")
+    table.add_column("Name")
+    table.add_column("Healthy")
+
+    for name, healthy in (payload.get("models") or {}).items():
+        table.add_row("model", str(name), "true" if healthy else "false")
+    for name, healthy in (payload.get("clusters") or {}).items():
+        table.add_row("cluster", str(name), "true" if healthy else "false")
+
+    console.print(f"ok: {'true' if payload.get('ok') else 'false'}")
     console.print(table)