nepher-cli 0.2.2__tar.gz → 0.2.4__tar.gz

{nepher_cli-0.2.2 → nepher_cli-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nepher-cli
-Version: 0.2.2
+Version: 0.2.4
 Summary: npcli — unified Nepher command-line interface for accounts, hackathons, EnvHub, tournaments, and SimStore
 Project-URL: Homepage, https://github.com/nepher-ai/nepher-cli
 Author: Nepher
@@ -20,7 +20,7 @@ Requires-Dist: keyring>=25.0.0
 Requires-Dist: platformdirs>=4.0.0
 Requires-Dist: rich>=13.7.0
 Provides-Extra: bittensor
-Requires-Dist: bittensor; extra == 'bittensor'
+Requires-Dist: bittensor-wallet>=4.1.0; extra == 'bittensor'
 Provides-Extra: dev
 Requires-Dist: pytest>=8.0.0; extra == 'dev'
 Requires-Dist: ruff>=0.4.0; extra == 'dev'
@@ -87,10 +87,10 @@ npcli tournament check --path ./my-agent
 npcli tournament check --path ./my-agent --verbose   # also show recommended-file warnings
 ```
 
-Submit an agent (requires `bittensor` for wallet signing):
+Submit an agent (requires `bittensor-wallet` for wallet signing):
 
 ```bash
-pip install bittensor
+pip install bittensor-wallet
 # or: pip install "nepher-cli[bittensor]"
 ```
 
@@ -154,13 +154,15 @@ npcli account api-keys revoke <key_id>
 
 ### Coldkey Registration
 
-Bind a Bittensor coldkey to your account (requires `bittensor` + `btcli` on PATH):
+Bind a Bittensor coldkey to your account (requires `bittensor-wallet`; `btcli` is optional fallback):
 
 ```bash
-pip install bittensor
+pip install bittensor-wallet
 npcli account register-coldkey --wallet <wallet_name>
 ```
 
+Signing uses the local coldkey via `bittensor-wallet` and does not import `btcli`. If you still have a mixed Bittensor venv (`scalecodec` + `cyscale`), `register-coldkey` keeps working as long as `bittensor-wallet` is installed.
+
 ## API Key Requirements
 
 - Must start with `nepher_`
@@ -177,8 +179,9 @@ npcli account register-coldkey --wallet <wallet_name>
 | `api key does not have hackathon access` | Enable Hackathon scope or use an unrestricted key |
 | `api key expired` | Run `npcli account api-keys create` |
 | `Several hackathons are accepting submissions` | Re-run with `--hackathon-id` |
-| `bittensor not installed` | `pip install bittensor` (only needed for `tournament submit`) |
+| `bittensor-wallet not installed` | `pip install bittensor-wallet` (needed for `tournament submit` and `account register-coldkey`) |
 | `Not logged in` | `npcli login --api-key nepher_...` |
+| `Conflict detected: 'scalecodec' ... conflicts with 'cyscale'` | Leftover `scalecodec` after a Bittensor upgrade. Prefer `pip install bittensor-wallet` so npcli never needs `btcli`. To repair `btcli` itself: `pip uninstall scalecodec cyscale -y && pip install -U cyscale --force-reinstall` |
 
 Run any command with `--help` for full flag details:
 

{nepher_cli-0.2.2 → nepher_cli-0.2.4}/README.md

@@ -59,10 +59,10 @@ npcli tournament check --path ./my-agent
 npcli tournament check --path ./my-agent --verbose   # also show recommended-file warnings
 ```
 
-Submit an agent (requires `bittensor` for wallet signing):
+Submit an agent (requires `bittensor-wallet` for wallet signing):
 
 ```bash
-pip install bittensor
+pip install bittensor-wallet
 # or: pip install "nepher-cli[bittensor]"
 ```
 
@@ -126,13 +126,15 @@ npcli account api-keys revoke <key_id>
 
 ### Coldkey Registration
 
-Bind a Bittensor coldkey to your account (requires `bittensor` + `btcli` on PATH):
+Bind a Bittensor coldkey to your account (requires `bittensor-wallet`; `btcli` is optional fallback):
 
 ```bash
-pip install bittensor
+pip install bittensor-wallet
 npcli account register-coldkey --wallet <wallet_name>
 ```
 
+Signing uses the local coldkey via `bittensor-wallet` and does not import `btcli`. If you still have a mixed Bittensor venv (`scalecodec` + `cyscale`), `register-coldkey` keeps working as long as `bittensor-wallet` is installed.
+
 ## API Key Requirements
 
 - Must start with `nepher_`
@@ -149,8 +151,9 @@ npcli account register-coldkey --wallet <wallet_name>
 | `api key does not have hackathon access` | Enable Hackathon scope or use an unrestricted key |
 | `api key expired` | Run `npcli account api-keys create` |
 | `Several hackathons are accepting submissions` | Re-run with `--hackathon-id` |
-| `bittensor not installed` | `pip install bittensor` (only needed for `tournament submit`) |
+| `bittensor-wallet not installed` | `pip install bittensor-wallet` (needed for `tournament submit` and `account register-coldkey`) |
 | `Not logged in` | `npcli login --api-key nepher_...` |
+| `Conflict detected: 'scalecodec' ... conflicts with 'cyscale'` | Leftover `scalecodec` after a Bittensor upgrade. Prefer `pip install bittensor-wallet` so npcli never needs `btcli`. To repair `btcli` itself: `pip uninstall scalecodec cyscale -y && pip install -U cyscale --force-reinstall` |
 
 Run any command with `--help` for full flag details:
 

{nepher_cli-0.2.2 → nepher_cli-0.2.4}/pyproject.toml

@@ -1,10 +1,10 @@
 [build-system]
-requires = ["hatchling"]
+requires = ["hatchling>=1.27,<1.32"]
 build-backend = "hatchling.build"
 
 [project]
 name = "nepher-cli"
-version = "0.2.2"
+version = "0.2.4"
 description = "npcli — unified Nepher command-line interface for accounts, hackathons, EnvHub, tournaments, and SimStore"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -29,7 +29,7 @@ dependencies = [
 ]
 
 [project.optional-dependencies]
-bittensor = ["bittensor"]
+bittensor = ["bittensor-wallet>=4.1.0"]
 dev = [
   "pytest>=8.0.0",
   "ruff>=0.4.0",
@@ -44,9 +44,11 @@ Homepage = "https://github.com/nepher-ai/nepher-cli"
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/nepher_cli"]
+core-metadata-version = "2.4"
 
 [tool.hatch.build.targets.sdist]
 include = ["src/nepher_cli", "README.md", "pyproject.toml"]
+core-metadata-version = "2.4"
 
 [tool.ruff]
 line-length = 100

nepher_cli-0.2.4/src/nepher_cli/__init__.py

@@ -0,0 +1,10 @@
+"""npcli — unified Nepher command-line interface."""
+
+from __future__ import annotations
+
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("nepher-cli")
+except PackageNotFoundError:  # pragma: no cover
+    __version__ = "0.0.0"

{nepher_cli-0.2.2 → nepher_cli-0.2.4}/src/nepher_cli/cli.py

@@ -15,7 +15,7 @@ from nepher_cli.commands.tournament import tournament
 @click.group(
     context_settings={"help_option_names": ["-h", "--help"], "max_content_width": 100},
 )
-@click.version_option(version=__version__, prog_name="npcli")
+@click.version_option(version=__version__, package_name="nepher-cli", prog_name="npcli")
 def main() -> None:
     """npcli — the unified Nepher command-line interface.
 
@@ -39,6 +39,11 @@ def main() -> None:
       npcli envhub list
       npcli tournament list
 
+    \b
+    Tournament submit requires bittensor-wallet for wallet signing:
+      pip install bittensor-wallet
+      # or: pip install "nepher-cli[bittensor]"
+
     Run any sub-command with --help for details and examples.
 
     API keys are created at https://account.nepher.ai (Account > API Keys).

{nepher_cli-0.2.2 → nepher_cli-0.2.4}/src/nepher_cli/commands/account.py

@@ -35,6 +35,25 @@ console = Console(stderr=True)
 
 BTCLI_SIGN_TIMEOUT_SECONDS = 120
 
+_WALLET_INSTALL_HINT = (
+    "Install the wallet library:\n"
+    "  [bold]pip install bittensor-wallet[/bold]\n"
+    "  [bold]pip install \"nepher-cli[bittensor]\"[/bold]"
+)
+
+_SCALECODEC_CONFLICT_HINT = (
+    "[red]btcli cannot start[/red] — [bold]scalecodec[/bold] (py-scale-codec) and "
+    "[bold]cyscale[/bold] are both installed and share the same Python namespace.\n\n"
+    "This is a known Bittensor CLI conflict. Fix it in this venv:\n\n"
+    "  [bold]pip uninstall scalecodec cyscale bt-decode -y[/bold]\n"
+    "  [bold]pip install -U cyscale --force-reinstall[/bold]\n\n"
+    "If [bold]btcli --version[/bold] still fails:\n\n"
+    "  [bold]pip uninstall scalecodec cyscale bt-decode bittensor bittensor-cli -y[/bold]\n"
+    "  [bold]pip install -U \"bittensor[cli]\" --force-reinstall[/bold]\n\n"
+    "npcli itself only needs [bold]bittensor-wallet[/bold] to sign. Prefer:\n"
+    "  [bold]pip install bittensor-wallet[/bold]"
+)
+
 # ---------------------------------------------------------------------------
 # Internal helpers
 # ---------------------------------------------------------------------------
@@ -146,16 +165,99 @@ def _extract_btcli_payload(stdout_text: str, original_message: str) -> dict[str,
     return data
 
 
+def _installed_distribution_names() -> set[str]:
+    try:
+        from importlib.metadata import distributions
+    except ImportError:  # pragma: no cover
+        return set()
+    names: set[str] = set()
+    for dist in distributions():
+        raw = dist.metadata.get("Name") or dist.metadata.get("name") or ""
+        if raw:
+            names.add(raw.lower().replace("_", "-"))
+    return names
+
+
+def has_scalecodec_cyscale_conflict(names: set[str] | None = None) -> bool:
+    """True when both SCALE codec packages occupy the ``scalecodec`` namespace."""
+    installed = names if names is not None else _installed_distribution_names()
+    has_legacy = "scalecodec" in installed or "py-scale-codec" in installed
+    return has_legacy and "cyscale" in installed
+
+
+def _looks_like_scalecodec_conflict(text: str) -> bool:
+    low = text.lower()
+    return "conflict detected" in low and "scalecodec" in low and "cyscale" in low
+
+
+def _signature_to_hex(sig: Any) -> str:
+    if isinstance(sig, (bytes, bytearray)):
+        return bytes(sig).hex()
+    text = str(sig).strip()
+    if text.startswith(("0x", "0X")):
+        return text[2:]
+    return text
+
+
+def _sign_with_bittensor_wallet(wallet_name: str, message: str) -> dict[str, Any] | None:
+    """Sign with ``bittensor_wallet`` (no btcli / ASI import). None if not installed."""
+    try:
+        from bittensor_wallet import Wallet  # type: ignore[import-untyped]
+    except ImportError:
+        return None
+    except RuntimeError as e:
+        if _looks_like_scalecodec_conflict(str(e)):
+            console.print(_SCALECODEC_CONFLICT_HINT)
+            raise SystemExit(1) from e
+        raise
+
+    wallet = Wallet(name=wallet_name)
+    if not wallet.coldkey_file.exists_on_device():
+        console.print(
+            f"[red]Coldkey not found[/red] for wallet [bold]{wallet_name}[/bold]. "
+            "Check the name with [bold]btcli wallet list[/bold]."
+        )
+        raise SystemExit(1)
+
+    console.print("[dim]Enter the coldkey password if prompted.[/dim]")
+    try:
+        keypair = wallet.coldkey
+    except Exception as e:
+        console.print(
+            f"[red]Could not unlock coldkey[/red] for wallet [bold]{wallet_name}[/bold]: {e}"
+        )
+        raise SystemExit(1) from e
+
+    sig_hex = _signature_to_hex(keypair.sign(message.encode("utf-8")))
+    return {
+        "message": message,
+        "address": keypair.ss58_address,
+        "signature": sig_hex,
+    }
+
+
+def sign_coldkey_challenge(wallet_name: str, message: str) -> dict[str, Any]:
+    """Sign a coldkey challenge with bittensor_wallet, falling back to btcli."""
+    signed = _sign_with_bittensor_wallet(wallet_name, message)
+    if signed is not None:
+        return signed
+    return run_btcli_sign(wallet_name, message)
+
+
 def run_btcli_sign(wallet_name: str, message: str) -> dict[str, Any]:
     """Run btcli wallet sign; inherit stdin/stderr so password prompts work."""
     btcli = shutil.which("btcli")
     if not btcli:
         console.print(
-            "[red]btcli not found[/red] — install Bittensor ([code]pip install bittensor[/code]) "
-            "and ensure [bold]btcli[/bold] is on your PATH."
+            "[red]bittensor-wallet not installed[/red] and [bold]btcli[/bold] is not on PATH.\n\n"
+            f"{_WALLET_INSTALL_HINT}"
         )
         raise SystemExit(1)
 
+    if has_scalecodec_cyscale_conflict():
+        console.print(_SCALECODEC_CONFLICT_HINT)
+        raise SystemExit(1)
+
     cmd = [btcli, "wallet", "sign", "--wallet-name", wallet_name, "--message", message, "--json-output"]
     try:
         proc = subprocess.Popen(cmd, stdin=sys.stdin, stderr=subprocess.PIPE, stdout=subprocess.PIPE, text=False)
@@ -200,7 +302,10 @@ def run_btcli_sign(wallet_name: str, message: str) -> dict[str, Any]:
     t_err.join(timeout=2)
     out = b"".join(stdout_chunks).decode("utf-8", errors="replace")
 
+    err = b"".join(stderr_chunks).decode("utf-8", errors="replace")
     if proc.returncode != 0:
+        if _looks_like_scalecodec_conflict(out + err):
+            console.print(_SCALECODEC_CONFLICT_HINT)
         raise SystemExit(1)
 
     data = _extract_btcli_payload(out, message)
@@ -242,12 +347,8 @@ def register_coldkey(wallet: str, api_key: str, base_url: str) -> int:
         return 1
 
     console.print(f"Signing with wallet [bold]{wallet}[/bold]...")
-    console.print(
-        "[dim]Passing through btcli output and prompts below. "
-        "Respond directly in this terminal when btcli asks for input.[/dim]"
-    )
     try:
-        signed = run_btcli_sign(wallet, msg)
+        signed = sign_coldkey_challenge(wallet, msg)
     except KeyboardInterrupt:
         console.print("\n[yellow]Interrupted — coldkey registration was not completed.[/yellow]")
         return 130
@@ -518,7 +619,7 @@ def api_keys_revoke(key_id: str, api_key: str | None) -> None:
 def cmd_register_coldkey(wallet: str, api_key: str | None) -> None:
     """Bind or replace the Bittensor coldkey on your Nepher account.
 
-    Requires btcli to be installed and on your PATH. Run the same command
+    Requires bittensor-wallet (or btcli on PATH). Run the same command
     with a different --wallet to replace an existing coldkey.
     """
     resolved_key = api_key or get_stored_api_key()

nepher_cli-0.2.4/src/nepher_cli/commands/highlight.py

@@ -0,0 +1,307 @@
+"""tournament highlight subgroup — manage verified play videos.
+
+Highlights are admin-uploaded videos bound to a submission (``--agent-id``) and an
+eval phase. Placement is never supplied here: the platform reads rank and score
+from the tournament leaderboard when the highlight is served.
+"""
+
+from __future__ import annotations
+
+import json as jsonlib
+import mimetypes
+from pathlib import Path
+from typing import Any
+
+import click
+import httpx
+from rich.console import Console
+from rich.table import Table
+
+from nepher_cli.config import TOURNAMENT_BACKEND
+from nepher_cli.core.http import (
+    authed_delete,
+    authed_get,
+    authed_patch,
+    authed_post,
+    parse_error_body,
+)
+
+console = Console(stderr=True)
+
+PHASES = ("public", "private")
+STATUSES = ("draft", "published")
+
+
+def _admin_url(api_url: str | None, path: str = "") -> str:
+    return f"{(api_url or TOURNAMENT_BACKEND).rstrip('/')}/api/v1/admin/highlights{path}"
+
+
+def _handle(response: httpx.Response) -> Any:
+    """Raise a friendly SystemExit on failure, else return the decoded body."""
+    if response.status_code >= 400:
+        console.print(
+            f"[red]{parse_error_body(response.text) or response.text.strip() or f'HTTP {response.status_code}'}[/red]"
+        )
+        raise SystemExit(1)
+    if response.status_code == 204 or not response.content:
+        return None
+    try:
+        return response.json()
+    except ValueError:
+        console.print("[red]Invalid JSON response.[/red]")
+        raise SystemExit(1)
+
+
+def _call(fn, *args, **kwargs) -> Any:
+    try:
+        return _handle(fn(*args, **kwargs))
+    except httpx.RequestError as e:
+        console.print(f"[red]Network error[/red]: {e}")
+        raise SystemExit(1) from e
+
+
+def _print_highlight(data: dict[str, Any], heading: str) -> None:
+    console.print(f"[green]{heading}[/green]")
+    for label, key in [
+        ("Highlight ID", "id"),
+        ("Tournament", "tournament_name"),
+        ("Submission", "agent_id"),
+        ("Hotkey", "miner_hotkey"),
+        ("Phase", "phase"),
+        ("Status", "status"),
+        ("Rank", "rank"),
+    ]:
+        value = data.get(key)
+        if value is not None:
+            console.print(f"  {label:<13}: [bold]{value}[/bold]")
+
+
+@click.group("highlight")
+def highlight() -> None:
+    """Manage verified play videos (admin only).
+
+    \b
+      list        List highlights, including drafts
+      upload      Upload a play video for a submission
+      publish     Make a highlight public
+      unpublish   Return a highlight to draft
+      delete      Remove a highlight and its video
+    """
+
+
+_api_url_option = click.option(
+    "--api-url", default=None, help=f"Tournament API URL (default: {TOURNAMENT_BACKEND})."
+)
+_api_key_option = click.option(
+    "--api-key", "--apikey", "api_key",
+    default=None, envvar="NEPHER_API_KEY", metavar="KEY",
+    help="Nepher API key. Falls back to stored credentials.",
+)
+_json_option = click.option("--json", "output_json", is_flag=True, help="Output raw JSON.")
+
+
+@highlight.command("list")
+@click.option("--tournament-id", default=None, help="Filter by tournament.")
+@click.option("--phase", type=click.Choice(PHASES), default=None, help="Filter by eval phase.")
+@click.option("--status", type=click.Choice(STATUSES), default=None, help="Filter by publish state.")
+@click.option("--limit", type=int, default=24, show_default=True, help="Highlights per page.")
+@_api_key_option
+@_api_url_option
+@_json_option
+def highlight_list(
+    tournament_id: str | None,
+    phase: str | None,
+    status: str | None,
+    limit: int,
+    api_key: str | None,
+    api_url: str | None,
+    output_json: bool,
+) -> None:
+    """List highlights with their live leaderboard placement."""
+    params = {
+        k: v
+        for k, v in {
+            "tournament_id": tournament_id,
+            "phase": phase,
+            "status": status,
+            "page_size": limit,
+        }.items()
+        if v is not None
+    }
+    data = _call(authed_get, _admin_url(api_url), api_key=api_key, params=params)
+
+    if output_json:
+        click.echo(jsonlib.dumps(data, indent=2))
+        return
+
+    items: list[dict[str, Any]] = data.get("items", [])
+    if not items:
+        console.print("[dim]No highlights found.[/dim]")
+        return
+
+    table = Table(show_header=True, header_style="bold", box=None)
+    table.add_column("ID", style="cyan", no_wrap=True)
+    table.add_column("Rank", justify="right")
+    table.add_column("Phase", no_wrap=True)
+    table.add_column("Status", no_wrap=True)
+    table.add_column("Hotkey")
+    table.add_column("Tournament", style="dim")
+
+    for item in items:
+        rank = "winner" if item.get("is_winner") else (item.get("rank") or "—")
+        table.add_row(
+            str(item.get("id", "")),
+            str(rank),
+            str(item.get("phase", "—")),
+            str(item.get("status", "—")),
+            str(item.get("miner_hotkey", "—")),
+            str(item.get("tournament_name") or "—"),
+        )
+
+    from rich import print as rprint
+
+    rprint(table)
+    console.print(f"\n[dim]{len(items)} of {data.get('total', len(items))} highlight(s).[/dim]")
+
+
+@highlight.command("upload")
+@click.option("--tournament-id", required=True, help="Tournament the run belongs to.")
+@click.option("--phase", type=click.Choice(PHASES), required=True, help="Eval phase of the run.")
+@click.option("--file", "video_path", type=click.Path(exists=True, dir_okay=False), required=True,
+              help="Play video (MP4 or WebM, max 100 MB).")
+@click.option("--agent-id", default=None, help="Submission the video shows.")
+@click.option("--rank", type=int, default=None,
+              help="Resolve the submission by its current rank in this phase instead of --agent-id.")
+@click.option("--title", default=None, help="Display title.")
+@click.option("--poster", "poster_path", type=click.Path(exists=True, dir_okay=False), default=None,
+              help="Optional poster image (JPG, PNG, WebP, max 10 MB).")
+@click.option("--publish", is_flag=True, help="Publish immediately instead of saving a draft.")
+@_api_key_option
+@_api_url_option
+@_json_option
+def highlight_upload(
+    tournament_id: str,
+    phase: str,
+    video_path: str,
+    agent_id: str | None,
+    rank: int | None,
+    title: str | None,
+    poster_path: str | None,
+    publish: bool,
+    api_key: str | None,
+    api_url: str | None,
+    output_json: bool,
+) -> None:
+    """Upload a verified play video and bind it to a submission.
+
+    Provide either --agent-id or --rank; the platform stores the resolved
+    submission so the card's placement always tracks the leaderboard.
+    """
+    if not agent_id and rank is None:
+        console.print("[red]Provide --agent-id or --rank.[/red]")
+        raise SystemExit(1)
+
+    form: dict[str, str] = {
+        "tournament_id": tournament_id,
+        "phase": phase,
+        "publish": str(publish).lower(),
+    }
+    if agent_id:
+        form["agent_id"] = agent_id
+    if rank is not None:
+        form["rank"] = str(rank)
+    if title:
+        form["title"] = title
+
+    video = Path(video_path)
+    files: dict[str, Any] = {
+        "file": (video.name, video.read_bytes(), mimetypes.guess_type(video.name)[0] or "video/mp4"),
+    }
+    if poster_path:
+        poster = Path(poster_path)
+        files["poster"] = (
+            poster.name,
+            poster.read_bytes(),
+            mimetypes.guess_type(poster.name)[0] or "image/jpeg",
+        )
+
+    console.print("Uploading play video...")
+    data = _call(
+        authed_post,
+        _admin_url(api_url, "/upload"),
+        api_key=api_key,
+        data=form,
+        files=files,
+        timeout=600.0,
+    )
+
+    if output_json:
+        click.echo(jsonlib.dumps(data, indent=2))
+        return
+
+    _print_highlight(data, "Highlight published." if publish else "Highlight saved as draft.")
+
+
+def _set_status(
+    highlight_id: str,
+    status: str,
+    api_key: str | None,
+    api_url: str | None,
+    output_json: bool,
+) -> None:
+    data = _call(
+        authed_patch,
+        _admin_url(api_url, f"/{highlight_id}"),
+        api_key=api_key,
+        json_body={"status": status},
+    )
+    if output_json:
+        click.echo(jsonlib.dumps(data, indent=2))
+        return
+    _print_highlight(data, f"Highlight marked {status}.")
+
+
+@highlight.command("publish")
+@click.argument("highlight_id")
+@_api_key_option
+@_api_url_option
+@_json_option
+def highlight_publish(
+    highlight_id: str, api_key: str | None, api_url: str | None, output_json: bool
+) -> None:
+    """Publish a draft highlight to the public feed."""
+    _set_status(highlight_id, "published", api_key, api_url, output_json)
+
+
+@highlight.command("unpublish")
+@click.argument("highlight_id")
+@_api_key_option
+@_api_url_option
+@_json_option
+def highlight_unpublish(
+    highlight_id: str, api_key: str | None, api_url: str | None, output_json: bool
+) -> None:
+    """Return a published highlight to draft."""
+    _set_status(highlight_id, "draft", api_key, api_url, output_json)
+
+
+@highlight.command("delete")
+@click.argument("highlight_id")
+@click.option("--keep-media", is_flag=True, help="Keep the video in the Media Library.")
+@click.option("--yes", "-y", is_flag=True, help="Skip the confirmation prompt.")
+@_api_key_option
+@_api_url_option
+def highlight_delete(
+    highlight_id: str,
+    keep_media: bool,
+    yes: bool,
+    api_key: str | None,
+    api_url: str | None,
+) -> None:
+    """Delete a highlight and, unless --keep-media, its video."""
+    if not yes:
+        click.confirm(f"Delete highlight {highlight_id}?", abort=True)
+
+    query = "?keep_media=true" if keep_media else ""
+    _call(authed_delete, _admin_url(api_url, f"/{highlight_id}{query}"), api_key=api_key)
+    console.print("[green]Highlight deleted.[/green]")

{nepher_cli-0.2.2 → nepher_cli-0.2.4}/src/nepher_cli/commands/tournament.py

@@ -17,6 +17,7 @@ from rich.console import Console
 from rich.panel import Panel
 from rich.table import Table
 
+from nepher_cli.commands.highlight import highlight as highlight_group
 from nepher_cli.config import TOURNAMENT_BACKEND
 from nepher_cli.core.credentials import get_auth_headers, get_stored_api_key
 from nepher_cli.core.http import parse_error_body
@@ -314,6 +315,9 @@ def tournament() -> None:
     """Browse tournaments, check leaderboards, validate agents, and submit to Subnet 49."""
 
 
+tournament.add_command(highlight_group)
+
+
 @tournament.command("list")
 @click.option("--active-only", is_flag=True, help="Show only active tournaments.")
 @click.option("--limit", type=int, default=50, show_default=True, help="Maximum tournaments to return.")
@@ -524,8 +528,9 @@ def tournament_submit(
     Your Nepher account is identified by the API key (--api-key, NEPHER_API_KEY,
     or credentials from npcli account login). The wallet hotkey signs the archive.
 
-    Requires [bold]bittensor[/bold] for wallet signing:
-      pip install bittensor
+    Requires [bold]bittensor-wallet[/bold] for wallet signing:
+      pip install bittensor-wallet
+      # or: pip install "nepher-cli[bittensor]"
     """
     resolved_key = _resolve_api_key(api_key)
     resolved_url = api_url or TOURNAMENT_BACKEND

{nepher_cli-0.2.2 → nepher_cli-0.2.4}/src/nepher_cli/core/http.py

@@ -67,6 +67,20 @@ def authed_post(
         return client.post(url, headers=headers, json=json_body, timeout=timeout)
 
 
+def authed_patch(
+    url: str,
+    *,
+    api_key: str | None = None,
+    json_body: dict[str, Any] | None = None,
+) -> httpx.Response:
+    """PATCH with auth headers resolved from credential store or override."""
+    from nepher_cli.core.credentials import get_auth_headers
+
+    headers = get_auth_headers(api_key)
+    with httpx.Client() as client:
+        return client.patch(url, headers=headers, json=json_body, timeout=60.0)
+
+
 def authed_delete(url: str, *, api_key: str | None = None) -> httpx.Response:
     """DELETE with auth headers resolved from credential store or override."""
     from nepher_cli.core.credentials import get_auth_headers

{nepher_cli-0.2.2 → nepher_cli-0.2.4}/src/nepher_cli/tournament/wallet.py

@@ -5,9 +5,9 @@ from __future__ import annotations
 import time
 
 _BITTENSOR_HINT = (
-    "Agent submission requires [bold]bittensor[/bold] for wallet signing.\n\n"
+    "Agent submission requires [bold]bittensor-wallet[/bold] for wallet signing.\n\n"
     "Install it with:\n"
-    "  [bold]pip install bittensor[/bold]\n\n"
+    "  [bold]pip install bittensor-wallet[/bold]\n\n"
     "Or if you installed nepher-cli via pip:\n"
     "  [bold]pip install \"nepher-cli[bittensor]\"[/bold]"
 )
@@ -26,7 +26,7 @@ def _require_wallet_class():
     except ImportError:
         from rich.console import Console
         Console(stderr=True).print(
-            f"[red]bittensor not installed.[/red]\n\n{_BITTENSOR_HINT}"
+            f"[red]bittensor-wallet not installed.[/red]\n\n{_BITTENSOR_HINT}"
         )
         raise SystemExit(1)
 

nepher_cli-0.2.2/src/nepher_cli/__init__.py

@@ -1,3 +0,0 @@
-"""npcli — unified Nepher command-line interface."""
-
-__version__ = "0.2.0"