hypercli-cli 2026.4.6__tar.gz → 2026.4.9__tar.gz

{hypercli_cli-2026.4.6 → hypercli_cli-2026.4.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hypercli-cli
-Version: 2026.4.6
+Version: 2026.4.9
 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.4.6
+Requires-Dist: hypercli-sdk>=2026.4.9
 Requires-Dist: mutagen>=1.47.0
 Requires-Dist: openai>=2.8.1
 Requires-Dist: pyyaml>=6.0
@@ -20,11 +20,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.4.6; extra == 'all'
+Requires-Dist: hypercli-sdk[comfyui]>=2026.4.9; 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.4.6; extra == 'comfyui'
+Requires-Dist: hypercli-sdk[comfyui]>=2026.4.9; extra == 'comfyui'
 Provides-Extra: dev
 Requires-Dist: pytest>=8.0.0; extra == 'dev'
 Requires-Dist: ruff>=0.3.0; extra == 'dev'

hypercli_cli-2026.4.9/hypercli_cli/__init__.py

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

{hypercli_cli-2026.4.6 → hypercli_cli-2026.4.9}/hypercli_cli/agent.py

@@ -10,9 +10,10 @@ import typer
 from rich.console import Console
 from rich.table import Table
 
+from hypercli import HyperCLI
+
 from .onboard import onboard as _onboard_fn
 from .voice import app as voice_app
-from .stt import transcribe as _stt_transcribe
 from .embed import app as embed_app
 
 app = typer.Typer(help="HyperAgent inference commands")
@@ -23,26 +24,6 @@ app.command("onboard")(_onboard_fn)
 app.add_typer(voice_app, name="voice")
 app.add_typer(embed_app, name="embed")
 
-
-@app.command("transcribe")
-def transcribe(
-    audio_file: Path = typer.Argument(..., help="Audio file to transcribe (wav, mp3, ogg, m4a, etc.)"),
-    model: str = typer.Option("turbo", "--model", "-m", help="Whisper model: tiny, base, small, medium, large-v3, turbo"),
-    language: str = typer.Option(None, "--language", "-l", help="Language code (e.g. en, de, fr). Auto-detect if omitted."),
-    device: str = typer.Option("auto", "--device", "-d", help="Device: auto, cpu, cuda"),
-    compute_type: str = typer.Option("auto", "--compute", help="Compute type: auto, int8, float16, float32"),
-    json_output: bool = typer.Option(False, "--json", help="Output as JSON with timestamps"),
-    output: Path = typer.Option(None, "--output", "-o", help="Write transcript to file"),
-):
-    """Transcribe audio to text using faster-whisper (runs locally).
-
-    Examples:
-      hyper agent transcribe voice.ogg
-      hyper agent transcribe meeting.mp3 --model large-v3 --language en
-      hyper agent transcribe audio.wav --json -o transcript.json
-    """
-    _stt_transcribe(audio_file, model, language, device, compute_type, json_output, output)
-
 # Check if wallet dependencies are available
 try:
     from x402 import x402Client
@@ -70,6 +51,30 @@ def require_x402_deps():
         raise typer.Exit(1)
 
 
+def _resolve_agent_query_key() -> str:
+    key = os.getenv("HYPER_AGENTS_API_KEY", "").strip() or os.getenv("HYPER_API_KEY", "").strip()
+    if key:
+        return key
+    if AGENT_KEY_PATH.exists():
+        try:
+            with open(AGENT_KEY_PATH) as f:
+                data = json.load(f)
+            key = str(data.get("key") or "").strip()
+            if key:
+                return key
+        except Exception:
+            pass
+    console.print("[red]❌ No HyperClaw API key found.[/red]")
+    console.print("Set HYPER_AGENTS_API_KEY or HYPER_API_KEY, or subscribe first with [bold]hyper agent subscribe[/bold].")
+    raise typer.Exit(1)
+
+
+def _get_agent_query_client(dev: bool) -> HyperCLI:
+    key = _resolve_agent_query_key()
+    api_base = DEV_API_BASE if dev else PROD_API_BASE
+    return HyperCLI(api_key=key, agent_api_key=key, api_url=api_base, agent_dev=dev)
+
+
 @app.command("subscribe")
 def subscribe(
     plan_id: str = typer.Argument("1aiu", help="Plan ID: 1aiu, 2aiu, 5aiu, 10aiu (default: 1aiu)"),
@@ -346,6 +351,104 @@ def plans(
     console.print("Subscribe with: [bold]hyper agent subscribe <plan_id> <amount>[/bold]")
 
 
+@app.command("current-plan")
+def current_plan(
+    dev: bool = typer.Option(False, "--dev", help="Use dev API"),
+    json_output: bool = typer.Option(False, "--json", help="Print raw JSON response"),
+):
+    """Show the effective current HyperClaw plan."""
+    client = _get_agent_query_client(dev)
+    current = client.agent.current_plan()
+
+    if json_output:
+        console.print_json(json.dumps(current.__dict__, indent=2, default=str))
+        return
+
+    console.print("\n[bold]Current HyperClaw Plan[/bold]\n")
+    console.print(f"Plan: [bold]{current.name}[/bold] ({current.id})")
+    console.print(f"TPM/RPM: {current.tpm_limit:,} / {current.rpm_limit:,}")
+    if current.pooled_tpd:
+        console.print(f"Pooled TPD: {current.pooled_tpd:,}")
+    if current.expires_at:
+        console.print(f"Expires: {current.expires_at.strftime('%Y-%m-%d %H:%M:%S %Z')}")
+    if current.provider:
+        console.print(f"Provider: {current.provider}")
+    console.print(f"Cancel at period end: {'yes' if current.cancel_at_period_end else 'no'}")
+    if current.slot_inventory:
+        console.print("\n[bold]Slots[/bold]")
+        for tier, inventory in current.slot_inventory.items():
+            console.print(
+                f"  {tier}: {inventory.get('used', 0)}/{inventory.get('granted', 0)} "
+                f"({inventory.get('available', 0)} available)"
+            )
+
+
+@app.command("subscriptions")
+def subscriptions(
+    dev: bool = typer.Option(False, "--dev", help="Use dev API"),
+    json_output: bool = typer.Option(False, "--json", help="Print raw JSON response"),
+):
+    """List your HyperClaw subscriptions/entitlements."""
+    client = _get_agent_query_client(dev)
+    items = client.agent.subscriptions()
+
+    if json_output:
+        console.print_json(json.dumps([item.__dict__ for item in items], indent=2, default=str))
+        return
+
+    table = Table(title="HyperClaw Subscriptions")
+    table.add_column("ID", style="cyan")
+    table.add_column("Plan", style="green")
+    table.add_column("Qty", justify="right")
+    table.add_column("Provider")
+    table.add_column("Status")
+    table.add_column("Expires")
+    for item in items:
+        expires = item.expires_at.strftime("%Y-%m-%d %H:%M:%S %Z") if item.expires_at else ""
+        table.add_row(item.id[:12], item.plan_name or item.plan_id, str(item.quantity), item.provider, item.status, expires)
+    console.print()
+    console.print(table)
+
+
+@app.command("subscription-summary")
+def subscription_summary(
+    dev: bool = typer.Option(False, "--dev", help="Use dev API"),
+    json_output: bool = typer.Option(False, "--json", help="Print raw JSON response"),
+):
+    """Show your effective HyperClaw entitlement summary."""
+    client = _get_agent_query_client(dev)
+    summary = client.agent.subscription_summary()
+
+    if json_output:
+        console.print_json(json.dumps({
+            "effective_plan_id": summary.effective_plan_id,
+            "current_subscription_id": summary.current_subscription_id,
+            "pooled_tpm_limit": summary.pooled_tpm_limit,
+            "pooled_rpm_limit": summary.pooled_rpm_limit,
+            "pooled_tpd": summary.pooled_tpd,
+            "slot_inventory": summary.slot_inventory,
+            "active_subscription_count": summary.active_subscription_count,
+            "active_subscriptions": [item.__dict__ for item in summary.active_subscriptions],
+            "subscriptions": [item.__dict__ for item in summary.subscriptions],
+            "user": summary.user,
+        }, indent=2, default=str))
+        return
+
+    console.print("\n[bold]HyperClaw Entitlement Summary[/bold]\n")
+    console.print(f"Effective plan: [bold]{summary.effective_plan_id}[/bold]")
+    console.print(f"Current subscription: {summary.current_subscription_id or ''}")
+    console.print(
+        f"Pooled limits: {summary.pooled_tpm_limit:,} TPM / "
+        f"{summary.pooled_rpm_limit:,} RPM / {summary.pooled_tpd:,} TPD"
+    )
+    console.print("\n[bold]Slots[/bold]")
+    for tier, inventory in summary.slot_inventory.items():
+        console.print(
+            f"  {tier}: {inventory.get('used', 0)}/{inventory.get('granted', 0)} "
+            f"({inventory.get('available', 0)} available)"
+        )
+
+
 @app.command("models")
 def models(
     dev: bool = typer.Option(False, "--dev", help="Use dev API"),

{hypercli_cli-2026.4.6 → hypercli_cli-2026.4.9}/hypercli_cli/cli.py

@@ -9,7 +9,7 @@ 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, wallet
+from . import agent, agents, billing, comfyui, files, flow, instances, jobs, keys, llm, user, voice, wallet
 from .output import output, spinner
 
 console = Console()
@@ -76,6 +76,7 @@ app.add_typer(keys.app, name="keys")
 app.add_typer(jobs.app, name="jobs")
 app.add_typer(llm.app, name="llm")
 app.add_typer(user.app, name="user")
+app.add_typer(voice.app, name="voice")
 app.add_typer(wallet.app, name="wallet")
 
 

{hypercli_cli-2026.4.6 → hypercli_cli-2026.4.9}/hypercli_cli/flow.py

@@ -420,7 +420,7 @@ def image_to_video(
     print_render_result(render, fmt, x402_result)
 
 
-@app.command("speaking-video")
+@app.command("speaking-video", hidden=True)
 def speaking_video(
     prompt: str = typer.Argument(..., help="Scene description prompt"),
     image: Optional[str] = typer.Option(None, "--image", "-i", help="Portrait image URL or local file path"),
@@ -579,7 +579,7 @@ def first_last_frame_video(
     print_render_result(render, fmt, x402_result)
 
 
-@app.command("audio-to-text")
+@app.command("audio-to-text", hidden=True)
 def audio_to_text(
     input: Optional[str] = typer.Argument(None, help="Audio URL or local file path"),
     file_id: Optional[str] = typer.Option(None, "--file-id", help="Pre-uploaded audio file ID"),
@@ -612,7 +612,7 @@ def audio_to_text(
     print_render_result(render, fmt, x402_result)
 
 
-@app.command("text-to-speech")
+@app.command("text-to-speech", hidden=True)
 def text_to_speech(
     text: str = typer.Argument(..., help="Text to synthesize"),
     mode: str = typer.Option("design", "--mode", "-m", help="TTS mode: custom, design, or clone"),

{hypercli_cli-2026.4.6 → hypercli_cli-2026.4.9}/hypercli_cli/llm.py

@@ -99,7 +99,7 @@ def _get_openai_client(api_key: str, api_base: str):
         from openai import OpenAI
     except ImportError:
         console.print("[red]❌ The llm command requires the openai package.[/red]")
-        console.print("Reinstall or upgrade with [bold]pip install 'hypercli-cli>=2026.4.6'[/bold].")
+        console.print("Reinstall or upgrade with [bold]pip install 'hypercli-cli>=2026.4.7'[/bold].")
         raise typer.Exit(1)
     return OpenAI(api_key=api_key, base_url=f"{api_base}/v1")
 

{hypercli_cli-2026.4.6 → hypercli_cli-2026.4.9}/hypercli_cli/stt.py

@@ -40,9 +40,9 @@ def transcribe(
     """Transcribe audio to text using faster-whisper (runs locally).
 
     Examples:
-      hyper agent stt transcribe voice.ogg
-      hyper agent stt transcribe meeting.mp3 --model large-v3 --language en
-      hyper agent stt transcribe audio.wav --json -o transcript.json
+      hyper voice transcribe voice.ogg
+      hyper voice transcribe meeting.mp3 --model large-v3 --language en
+      hyper voice transcribe audio.wav --json -o transcript.json
     """
     if not audio_file.exists():
         console.print(f"[red]❌ File not found: {audio_file}[/red]")

{hypercli_cli-2026.4.6 → hypercli_cli-2026.4.9}/hypercli_cli/voice.py

@@ -6,8 +6,9 @@ from pathlib import Path
 import typer
 from rich.console import Console
 from hypercli import HyperCLI, APIError
+from .stt import transcribe as _stt_transcribe
 
-app = typer.Typer(help="Voice API — text-to-speech, voice cloning, voice design")
+app = typer.Typer(help="Voice commands — text-to-speech, voice cloning, voice design, and local transcription")
 console = Console()
 
 HYPERCLI_DIR = Path.home() / ".hypercli"
@@ -84,6 +85,26 @@ def _post_voice(endpoint: str, api_key: str, output: Path, base_url: str | None
         raise typer.Exit(1)
 
 
+@app.command("transcribe")
+def transcribe(
+    audio_file: Path = typer.Argument(..., help="Audio file to transcribe (wav, mp3, ogg, m4a, etc.)"),
+    model: str = typer.Option("turbo", "--model", "-m", help="Whisper model: tiny, base, small, medium, large-v3, turbo"),
+    language: str = typer.Option(None, "--language", "-l", help="Language code (e.g. en, de, fr). Auto-detect if omitted."),
+    device: str = typer.Option("auto", "--device", "-d", help="Device: auto, cpu, cuda"),
+    compute_type: str = typer.Option("auto", "--compute", help="Compute type: auto, int8, float16, float32"),
+    json_output: bool = typer.Option(False, "--json", help="Output as JSON with timestamps"),
+    output: Path = typer.Option(None, "--output", "-o", help="Write transcript to file"),
+):
+    """Transcribe audio locally using faster-whisper.
+
+    Examples:
+      hyper voice transcribe voice.ogg
+      hyper voice transcribe meeting.mp3 --model large-v3 --language en
+      hyper voice transcribe audio.wav --json -o transcript.json
+    """
+    _stt_transcribe(audio_file, model, language, device, compute_type, json_output, output)
+
+
 @app.command("tts")
 def tts(
     text: str = typer.Argument(..., help="Text to synthesize"),
@@ -97,8 +118,8 @@ def tts(
     """Generate speech from text using a preset voice.
 
     Examples:
-      hyper agent voice tts "Hello world"
-      hyper agent voice tts "Bonjour" -v Etienne -l french -f opus -o hello.opus
+      hyper voice tts "Hello world"
+      hyper voice tts "Bonjour" -v Etienne -l french -f opus -o hello.opus
     """
     api_key = _get_api_key(key)
     if output is None:
@@ -129,8 +150,8 @@ def clone(
     """Clone a voice from reference audio.
 
     Examples:
-      hyper agent voice clone "Hello" --ref voice.wav
-      hyper agent voice clone "Test" -r ref.wav -l english -f mp3 -o cloned.mp3
+      hyper voice clone "Hello" --ref voice.wav
+      hyper voice clone "Test" -r ref.wav -l english -f mp3 -o cloned.mp3
     """
     api_key = _get_api_key(key)
     if output is None:
@@ -167,8 +188,8 @@ def design(
     """Design a voice from a text description.
 
     Examples:
-      hyper agent voice design "Hello" --desc "deep male voice, British accent"
-      hyper agent voice design "Test" -d "young woman, cheerful" -f mp3 -o designed.mp3
+      hyper voice design "Hello" --desc "deep male voice, British accent"
+      hyper voice design "Test" -d "young woman, cheerful" -f mp3 -o designed.mp3
     """
     api_key = _get_api_key(key)
     if output is None:

{hypercli_cli-2026.4.6 → hypercli_cli-2026.4.9}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "hypercli-cli"
-version = "2026.4.6"
+version = "2026.4.9"
 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.4.6",
+    "hypercli-sdk>=2026.4.9",
     "openai>=2.8.1",
     "typer>=0.20.0",
     "rich>=14.2.0",
@@ -25,7 +25,7 @@ dependencies = [
 
 [project.optional-dependencies]
 comfyui = [
-    "hypercli-sdk[comfyui]>=2026.4.6",
+    "hypercli-sdk[comfyui]>=2026.4.9",
 ]
 wallet = [
     "x402[httpx,evm]>=2.0.0",
@@ -38,7 +38,7 @@ stt = [
     "faster-whisper>=1.1.0",
 ]
 all = [
-    "hypercli-sdk[comfyui]>=2026.4.6",
+    "hypercli-sdk[comfyui]>=2026.4.9",
     "x402[httpx,evm]>=2.0.0",
     "eth-account>=0.13.0",
     "web3>=7.0.0",

hypercli_cli-2026.4.9/tests/test_flow_visibility.py

@@ -0,0 +1,17 @@
+from typer.testing import CliRunner
+
+from hypercli_cli.cli import app
+
+
+runner = CliRunner()
+
+
+def test_flow_help_hides_voice_and_transcription_flows():
+    result = runner.invoke(app, ["flow", "--help"])
+
+    assert result.exit_code == 0
+    assert "speaking-video" not in result.stdout
+    assert "audio-to-text" not in result.stdout
+    assert "text-to-speech" not in result.stdout
+    assert "text-to-image" in result.stdout
+    assert "image-to-video" in result.stdout

hypercli_cli-2026.4.9/tests/test_voice_command.py

@@ -0,0 +1,72 @@
+from pathlib import Path
+
+from typer.testing import CliRunner
+
+from hypercli_cli.cli import app
+
+
+runner = CliRunner()
+
+
+def test_top_level_voice_transcribe_delegates_to_local_stt(monkeypatch, tmp_path):
+    import hypercli_cli.voice as voice
+
+    called = {}
+
+    def _fake_transcribe(audio_file, model, language, device, compute_type, json_output, output):
+        called["audio_file"] = audio_file
+        called["model"] = model
+        called["language"] = language
+        called["device"] = device
+        called["compute_type"] = compute_type
+        called["json_output"] = json_output
+        called["output"] = output
+
+    monkeypatch.setattr(voice, "_stt_transcribe", _fake_transcribe)
+
+    audio_file = tmp_path / "voice.ogg"
+    audio_file.write_bytes(b"ogg")
+    output = tmp_path / "transcript.txt"
+
+    result = runner.invoke(
+        app,
+        [
+            "voice",
+            "transcribe",
+            str(audio_file),
+            "--model",
+            "turbo",
+            "--device",
+            "cpu",
+            "--compute",
+            "int8",
+            "--output",
+            str(output),
+        ],
+    )
+
+    assert result.exit_code == 0, result.stdout
+    assert called == {
+        "audio_file": audio_file,
+        "model": "turbo",
+        "language": None,
+        "device": "cpu",
+        "compute_type": "int8",
+        "json_output": False,
+        "output": output,
+    }
+
+
+def test_top_level_voice_group_is_registered():
+    result = runner.invoke(app, ["voice", "--help"])
+
+    assert result.exit_code == 0
+    assert "Voice commands" in result.stdout
+    assert "transcribe" in result.stdout
+
+
+def test_agent_transcribe_command_is_removed():
+    result = runner.invoke(app, ["agent", "transcribe", "voice.ogg"])
+
+    assert result.exit_code != 0
+    assert "No such command 'transcribe'" in result.stdout

hypercli_cli-2026.4.6/hypercli_cli/__init__.py

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