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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hypercli-cli
-Version: 2026.3.22
+Version: 2026.3.25
 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.22
+Requires-Dist: hypercli-sdk>=2026.3.25
 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.22; extra == 'all'
+Requires-Dist: hypercli-sdk[comfyui]>=2026.3.25; 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.22; extra == 'comfyui'
+Requires-Dist: hypercli-sdk[comfyui]>=2026.3.25; 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-2026.3.25}/hypercli_cli/agents.py

@@ -653,7 +653,10 @@ def cp(
             local_path = agents.cp_from(pod, src_path, dst_path)
             console.print(f"[green]✓[/green] Copied [bold]{src_agent_id[:12]}:{src_path}[/bold] to [bold]{local_path}[/bold]")
     except Exception as e:
-        console.print(f"[red]❌ Copy failed: {e}[/red]")
+        message = str(e)
+        if message.startswith("Path is a directory:"):
+            message = f"{message} Copy expects a file path, not a directory."
+        console.print(f"[red]❌ Copy failed: {message}[/red]")
         raise typer.Exit(1)
 
 
@@ -1000,6 +1003,59 @@ def gateway_cron(
     _run_async(_run())
 
 
+@app.command("cron-add")
+def gateway_cron_add(
+    agent_id: str = typer.Argument(None, help="Agent ID or name"),
+    job_json: str = typer.Argument(..., help='Cron job JSON, e.g. \'{"name":"backup","schedule":"0 * * * *","command":"echo hi"}\''),
+):
+    """Add a cron job to an agent's gateway."""
+    pod = _require_openclaw_agent(_get_pod_with_token(agent_id))
+    try:
+        job_data = json.loads(job_json)
+    except json.JSONDecodeError as e:
+        console.print(f"[red]Invalid JSON: {e}[/red]")
+        raise typer.Exit(1)
+
+    async def _run():
+        result = await pod.cron_add(job_data)
+        console.print(f"[green]Cron job added[/green]")
+        console.print_json(json.dumps(result, default=str))
+
+    _run_async(_run())
+
+
+@app.command("cron-remove")
+def gateway_cron_remove(
+    agent_id: str = typer.Argument(None, help="Agent ID or name"),
+    job_id: str = typer.Argument(..., help="Cron job ID to remove"),
+):
+    """Remove a cron job from an agent's gateway."""
+    pod = _require_openclaw_agent(_get_pod_with_token(agent_id))
+
+    async def _run():
+        await pod.cron_remove(job_id)
+        console.print(f"[green]Cron job {job_id} removed[/green]")
+
+    _run_async(_run())
+
+
+@app.command("cron-run")
+def gateway_cron_run(
+    agent_id: str = typer.Argument(None, help="Agent ID or name"),
+    job_id: str = typer.Argument(..., help="Cron job ID to trigger"),
+):
+    """Manually trigger a cron job on an agent's gateway."""
+    pod = _require_openclaw_agent(_get_pod_with_token(agent_id))
+
+    async def _run():
+        result = await pod.cron_run(job_id)
+        console.print(f"[green]Cron job {job_id} triggered[/green]")
+        if result:
+            console.print_json(json.dumps(result, default=str))
+
+    _run_async(_run())
+
+
 @app.command("gateway-chat")
 def gateway_chat(
     agent_id: str = typer.Argument(None, help="Agent ID or name"),

{hypercli_cli-2026.3.22 → hypercli_cli-2026.3.25}/hypercli_cli/cli.py

@@ -8,7 +8,7 @@ from rich.prompt import Prompt
 from hypercli import HyperCLI, APIError, configure
 from hypercli.config import CONFIG_FILE
 
-from . import agent, agents, billing, comfyui, flow, instances, jobs, keys, user, wallet
+from . import agent, agents, billing, comfyui, files, flow, instances, jobs, keys, user, wallet
 
 console = Console()
 
@@ -61,6 +61,7 @@ app.add_typer(agents.app, name="agents")
 app.add_typer(agent.app, name="agent")
 app.add_typer(billing.app, name="billing")
 app.add_typer(comfyui.app, name="comfyui")
+app.add_typer(files.app, name="files")
 app.add_typer(flow.app, name="flow")
 app.add_typer(instances.app, name="instances")
 app.add_typer(keys.app, name="keys")

hypercli_cli-2026.3.25/hypercli_cli/files.py

@@ -0,0 +1,111 @@
+"""File management CLI commands"""
+import os
+import typer
+from rich.console import Console
+from rich.table import Table
+
+app = typer.Typer(help="Upload, inspect, and delete files on the platform")
+console = Console()
+
+
+def _get_client():
+    from hypercli import HyperCLI
+    return HyperCLI()
+
+
+def _fmt_size(size: int) -> str:
+    """Format file size for display."""
+    if size < 1024:
+        return f"{size} B"
+    if size < 1024 * 1024:
+        return f"{size / 1024:.1f} KB"
+    return f"{size / (1024 * 1024):.1f} MB"
+
+
+@app.command("upload")
+def upload_file(
+    file_path: str = typer.Argument(..., help="Path to local file to upload"),
+    wait: bool = typer.Option(True, "--wait/--no-wait", help="Wait for upload to complete"),
+):
+    """Upload a file for use in flows and renders."""
+    if not os.path.isfile(file_path):
+        console.print(f"[red]File not found: {file_path}[/red]")
+        raise typer.Exit(1)
+
+    client = _get_client()
+    console.print(f"Uploading [cyan]{os.path.basename(file_path)}[/cyan] ({_fmt_size(os.path.getsize(file_path))})...")
+    f = client.files.upload(file_path)
+    console.print(f"[green]Uploaded[/green]  ID: [bold]{f.id}[/bold]")
+
+    if wait and f.state == "processing":
+        console.print("Waiting for processing...", end="")
+        f = client.files.wait_ready(f.id)
+        console.print(f" [green]done[/green]")
+
+    console.print(f"  Filename:  {f.filename}")
+    console.print(f"  Type:      {f.content_type}")
+    console.print(f"  Size:      {_fmt_size(f.file_size)}")
+    console.print(f"  State:     {f.state or 'ready'}")
+    console.print(f"  URL:       [dim]{f.url}[/dim]")
+
+
+@app.command("upload-url")
+def upload_url(
+    url: str = typer.Argument(..., help="URL to download and upload"),
+    wait: bool = typer.Option(True, "--wait/--no-wait", help="Wait for upload to complete"),
+):
+    """Upload a file from a URL."""
+    client = _get_client()
+    console.print(f"Uploading from URL...")
+    f = client.files.upload_url(url)
+    console.print(f"[green]Queued[/green]  ID: [bold]{f.id}[/bold]")
+
+    if wait and f.state == "processing":
+        console.print("Waiting for processing...", end="")
+        f = client.files.wait_ready(f.id)
+        console.print(f" [green]done[/green]")
+
+    console.print(f"  Filename:  {f.filename}")
+    console.print(f"  State:     {f.state or 'ready'}")
+
+
+@app.command("get")
+def get_file(
+    file_id: str = typer.Argument(..., help="File ID"),
+):
+    """Get file info and status."""
+    client = _get_client()
+    f = client.files.get(file_id)
+
+    table = Table(title=f"File {f.id[:12]}...")
+    table.add_column("Field", style="dim")
+    table.add_column("Value")
+
+    table.add_row("ID", f.id)
+    table.add_row("Filename", f.filename)
+    table.add_row("Type", f.content_type)
+    table.add_row("Size", _fmt_size(f.file_size))
+    table.add_row("State", f.state or "ready")
+    table.add_row("URL", f.url)
+    if f.error:
+        table.add_row("Error", f"[red]{f.error}[/red]")
+    if f.created_at:
+        table.add_row("Created", str(f.created_at))
+
+    console.print(table)
+
+
+@app.command("delete")
+def delete_file(
+    file_id: str = typer.Argument(..., help="File ID to delete"),
+    yes: bool = typer.Option(False, "--yes", "-y", help="Skip confirmation"),
+):
+    """Delete an uploaded file."""
+    if not yes:
+        confirm = typer.confirm(f"Delete file {file_id[:12]}...?")
+        if not confirm:
+            raise typer.Abort()
+
+    client = _get_client()
+    client.files.delete(file_id)
+    console.print(f"[green]File {file_id[:12]}... deleted[/green]")

{hypercli_cli-2026.3.22 → hypercli_cli-2026.3.25}/hypercli_cli/jobs.py

@@ -44,17 +44,28 @@ def _resolve_job_id(client: HyperCLI, job_id: str) -> str:
 def list_jobs(
     state: Optional[str] = typer.Option(None, "--state", "-s", help="Filter by state"),
     tag: list[str] = typer.Option([], "--tag", help="Filter by tag as KEY=VALUE", metavar="KEY=VALUE"),
+    page: int = typer.Option(1, "--page", min=1, help="Page number (1-indexed)"),
+    page_size: int = typer.Option(50, "--page-size", min=1, max=100, help="Items per page (max 100)"),
     fmt: str = typer.Option("table", "--output", "-o", help="Output format: table|json"),
 ):
     """List all jobs"""
     client = get_client()
     tags = _parse_tags(tag) if tag else None
     with spinner("Fetching jobs..."):
-        jobs = client.jobs.list(state=state, tags=tags)
+        result = client.jobs.list_page(state=state, tags=tags, page=page, page_size=page_size)
 
     if fmt == "json":
-        output(jobs, "json")
+        output(
+            {
+                "jobs": [job.__dict__ for job in result.jobs],
+                "total_count": result.total_count,
+                "page": result.page,
+                "page_size": result.page_size,
+            },
+            "json",
+        )
     else:
+        jobs = result.jobs
         if not jobs:
             console.print("[dim]No jobs found[/dim]")
             return
@@ -63,6 +74,11 @@ def list_jobs(
             "table",
             ["job_id", "state", "gpu_type", "gpu_count", "region", "time_left", "runtime", "hostname"],
         )
+        total_pages = max((result.total_count + result.page_size - 1) // result.page_size, 1)
+        console.print(
+            f"[dim]Page {result.page}/{total_pages} | "
+            f"{len(result.jobs)} shown | {result.total_count} total[/dim]"
+        )
 
 
 @app.command("get")

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

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "hypercli-cli"
-version = "2026.3.22"
+version = "2026.3.25"
 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.22",
+    "hypercli-sdk>=2026.3.25",
     "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.22",
+    "hypercli-sdk[comfyui]>=2026.3.25",
 ]
 wallet = [
     "x402[httpx,evm]>=2.0.0",
@@ -37,7 +37,7 @@ stt = [
     "faster-whisper>=1.1.0",
 ]
 all = [
-    "hypercli-sdk[comfyui]>=2026.3.22",
+    "hypercli-sdk[comfyui]>=2026.3.25",
     "x402[httpx,evm]>=2.0.0",
     "eth-account>=0.13.0",
     "web3>=7.0.0",

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

@@ -172,3 +172,20 @@ def test_agent_shell_command(monkeypatch):
 
     assert result.exit_code == 0
     assert called["agent_id"] == "agent-xyz"
+
+
+def test_agents_cp_reports_directory_path_error(monkeypatch, tmp_path):
+    class FakeDeployments:
+        def cp_from(self, _pod, src_path, dst_path):
+            assert src_path == ".openclaw"
+            assert str(dst_path).endswith("download")
+            raise ValueError("Path is a directory: .openclaw. Use files_list(path) instead.")
+
+    monkeypatch.setattr("hypercli_cli.agents._get_deployments_client", lambda: FakeDeployments())
+    monkeypatch.setattr("hypercli_cli.agents._get_pod_with_token", lambda agent_id: SimpleNamespace(id=agent_id))
+
+    result = runner.invoke(app, ["agents", "cp", "agent-xyz:.openclaw", str(tmp_path / "download")])
+
+    assert result.exit_code == 1
+    assert "Path is a directory: .openclaw." in result.stdout
+    assert "Copy expects a file path, not a directory." in result.stdout

hypercli_cli-2026.3.25/tests/test_jobs_list_tags.py

@@ -0,0 +1,70 @@
+from types import SimpleNamespace
+
+from typer.testing import CliRunner
+
+from hypercli_cli.cli import app
+
+
+runner = CliRunner()
+
+
+def test_jobs_list_passes_tags(monkeypatch):
+    captured = {}
+
+    class FakeJobs:
+        def list_page(self, state=None, tags=None, page=None, page_size=None):
+            captured["state"] = state
+            captured["tags"] = tags
+            captured["page"] = page
+            captured["page_size"] = page_size
+            return SimpleNamespace(jobs=[], total_count=0, page=page, page_size=page_size)
+
+    fake_client = SimpleNamespace(jobs=FakeJobs())
+    monkeypatch.setattr("hypercli_cli.jobs.get_client", lambda: fake_client)
+
+    result = runner.invoke(
+        app,
+        ["jobs", "list", "--state", "running", "--tag", "team=ml", "--tag", "env=prod"],
+    )
+
+    assert result.exit_code == 0
+    assert captured == {
+        "state": "running",
+        "tags": {"team": "ml", "env": "prod"},
+        "page": 1,
+        "page_size": 50,
+    }
+
+
+def test_jobs_list_passes_backend_pagination(monkeypatch):
+    captured = {}
+
+    class FakeJobs:
+        def list_page(self, state=None, tags=None, page=None, page_size=None):
+            captured["page"] = page
+            captured["page_size"] = page_size
+            return SimpleNamespace(jobs=[], total_count=0, page=page, page_size=page_size)
+
+    fake_client = SimpleNamespace(jobs=FakeJobs())
+    monkeypatch.setattr("hypercli_cli.jobs.get_client", lambda: fake_client)
+
+    result = runner.invoke(app, ["jobs", "list", "--page", "3", "--page-size", "25"])
+
+    assert result.exit_code == 0
+    assert captured == {"page": 3, "page_size": 25}
+
+
+def test_jobs_list_rejects_invalid_tag(monkeypatch):
+    fake_client = SimpleNamespace(
+        jobs=SimpleNamespace(
+            list_page=lambda state=None, tags=None, page=None, page_size=None: SimpleNamespace(
+                jobs=[], total_count=0, page=page, page_size=page_size
+            )
+        )
+    )
+    monkeypatch.setattr("hypercli_cli.jobs.get_client", lambda: fake_client)
+
+    result = runner.invoke(app, ["jobs", "list", "--tag", "broken"])
+
+    assert result.exit_code == 1
+    assert "Expected KEY=VALUE" in result.stdout

hypercli_cli-2026.3.22/tests/test_jobs_list_tags.py

@@ -1,39 +0,0 @@
-from types import SimpleNamespace
-
-from typer.testing import CliRunner
-
-from hypercli_cli.cli import app
-
-
-runner = CliRunner()
-
-
-def test_jobs_list_passes_tags(monkeypatch):
-    captured = {}
-
-    class FakeJobs:
-        def list(self, state=None, tags=None):
-            captured["state"] = state
-            captured["tags"] = tags
-            return []
-
-    fake_client = SimpleNamespace(jobs=FakeJobs())
-    monkeypatch.setattr("hypercli_cli.jobs.get_client", lambda: fake_client)
-
-    result = runner.invoke(
-        app,
-        ["jobs", "list", "--state", "running", "--tag", "team=ml", "--tag", "env=prod"],
-    )
-
-    assert result.exit_code == 0
-    assert captured == {"state": "running", "tags": {"team": "ml", "env": "prod"}}
-
-
-def test_jobs_list_rejects_invalid_tag(monkeypatch):
-    fake_client = SimpleNamespace(jobs=SimpleNamespace(list=lambda state=None, tags=None: []))
-    monkeypatch.setattr("hypercli_cli.jobs.get_client", lambda: fake_client)
-
-    result = runner.invoke(app, ["jobs", "list", "--tag", "broken"])
-
-    assert result.exit_code == 1
-    assert "Expected KEY=VALUE" in result.stdout