fluxhive-cli 0.1.0__tar.gz

fluxhive_cli-0.1.0/LICENSE

@@ -0,0 +1,23 @@
+FluxHive License
+
+Copyright (c) 2025 FluxHive
+
+This repository contains multiple components with different licenses:
+
+1. Agent Component (app-agent/)
+   Licensed under the FluxHive Agent Non-Commercial Copyleft License v1.0.
+   - Open source: You may view, modify, and distribute the source code
+   - Non-commercial: Commercial use is prohibited (separate commercial license required)
+   - Copyleft: Modifications and derivative works must remain open source
+   See app-agent/LICENSE for full details.
+
+2. Control Server (app-control/)
+   Proprietary and confidential.
+   Unauthorized copying or distribution is strictly prohibited.
+
+3. Web Client (app-web/)
+   Proprietary and confidential.
+   Unauthorized copying or distribution is strictly prohibited.
+
+For commercial licensing or enterprise support, please contact:
+[dramwig@gmail.com]

fluxhive_cli-0.1.0/PKG-INFO

@@ -0,0 +1,94 @@
+Metadata-Version: 2.4
+Name: fluxhive-cli
+Version: 0.1.0
+Summary: FluxHive control-plane command line client
+Author: FluxHive Team
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# @fluxhive/cli
+
+Node-installable launcher and Python implementation for the FluxHive control-plane CLI.
+
+The CLI talks to Control Server HTTP APIs and does not implement scheduling or agent runtime logic locally.
+
+The package exposes two equivalent commands:
+
+```bash
+fluxhive
+fluxhivectl
+```
+
+## npm Install
+
+```bash
+npm install -g @fluxhive/cli
+```
+
+## PyPI Install
+
+```bash
+pipx install fluxhive-cli
+```
+
+The compatibility package `fluxhivectl` also installs the same CLI:
+
+```bash
+pipx install fluxhivectl
+```
+
+Or with pip:
+
+```bash
+python -m pip install fluxhive-cli
+```
+
+Python 3.10 or newer must be available on `PATH`. You can also point the launcher at a specific Python executable:
+
+```bash
+FLUXHIVE_PYTHON=/path/to/python fluxhive --version
+```
+
+On Windows PowerShell:
+
+```powershell
+$env:FLUXHIVE_PYTHON = "C:\Python312\python.exe"
+fluxhive --version
+```
+
+## Development Install
+
+```bash
+python -m pip install -e .
+npm test
+```
+
+## Quick Start
+
+```bash
+fluxhive config base_url http://127.0.0.1:8001
+fluxhive auth login --username <username>
+
+fluxhive jobs list
+fluxhive agents list
+fluxhive runs list --limit 20
+```
+
+You can also use environment variables:
+
+```bash
+FLUXHIVE_CONTROL_URL=http://127.0.0.1:8001
+FLUXHIVE_ACCESS_TOKEN=<access-token>
+FLUXHIVE_REFRESH_TOKEN=<refresh-token>
+```
+
+## Command Groups
+
+- `auth`: login, refresh tokens, inspect current user, clear local tokens
+- `config`: read and write local CLI configuration
+- `jobs`: create, list, inspect, publish, run, cancel, clone, and delete jobs
+- `runs`: list run attempts, inspect run attempts, print stored run logs
+- `agents`: list agents, inspect GPUs, inspect queues, rename agents
+- `nodes`: alias for `agents`

fluxhive_cli-0.1.0/README.md

@@ -0,0 +1,84 @@
+# @fluxhive/cli
+
+Node-installable launcher and Python implementation for the FluxHive control-plane CLI.
+
+The CLI talks to Control Server HTTP APIs and does not implement scheduling or agent runtime logic locally.
+
+The package exposes two equivalent commands:
+
+```bash
+fluxhive
+fluxhivectl
+```
+
+## npm Install
+
+```bash
+npm install -g @fluxhive/cli
+```
+
+## PyPI Install
+
+```bash
+pipx install fluxhive-cli
+```
+
+The compatibility package `fluxhivectl` also installs the same CLI:
+
+```bash
+pipx install fluxhivectl
+```
+
+Or with pip:
+
+```bash
+python -m pip install fluxhive-cli
+```
+
+Python 3.10 or newer must be available on `PATH`. You can also point the launcher at a specific Python executable:
+
+```bash
+FLUXHIVE_PYTHON=/path/to/python fluxhive --version
+```
+
+On Windows PowerShell:
+
+```powershell
+$env:FLUXHIVE_PYTHON = "C:\Python312\python.exe"
+fluxhive --version
+```
+
+## Development Install
+
+```bash
+python -m pip install -e .
+npm test
+```
+
+## Quick Start
+
+```bash
+fluxhive config base_url http://127.0.0.1:8001
+fluxhive auth login --username <username>
+
+fluxhive jobs list
+fluxhive agents list
+fluxhive runs list --limit 20
+```
+
+You can also use environment variables:
+
+```bash
+FLUXHIVE_CONTROL_URL=http://127.0.0.1:8001
+FLUXHIVE_ACCESS_TOKEN=<access-token>
+FLUXHIVE_REFRESH_TOKEN=<refresh-token>
+```
+
+## Command Groups
+
+- `auth`: login, refresh tokens, inspect current user, clear local tokens
+- `config`: read and write local CLI configuration
+- `jobs`: create, list, inspect, publish, run, cancel, clone, and delete jobs
+- `runs`: list run attempts, inspect run attempts, print stored run logs
+- `agents`: list agents, inspect GPUs, inspect queues, rename agents
+- `nodes`: alias for `agents`

fluxhive_cli-0.1.0/fluxhive_cli.egg-info/PKG-INFO

@@ -0,0 +1,94 @@
+Metadata-Version: 2.4
+Name: fluxhive-cli
+Version: 0.1.0
+Summary: FluxHive control-plane command line client
+Author: FluxHive Team
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# @fluxhive/cli
+
+Node-installable launcher and Python implementation for the FluxHive control-plane CLI.
+
+The CLI talks to Control Server HTTP APIs and does not implement scheduling or agent runtime logic locally.
+
+The package exposes two equivalent commands:
+
+```bash
+fluxhive
+fluxhivectl
+```
+
+## npm Install
+
+```bash
+npm install -g @fluxhive/cli
+```
+
+## PyPI Install
+
+```bash
+pipx install fluxhive-cli
+```
+
+The compatibility package `fluxhivectl` also installs the same CLI:
+
+```bash
+pipx install fluxhivectl
+```
+
+Or with pip:
+
+```bash
+python -m pip install fluxhive-cli
+```
+
+Python 3.10 or newer must be available on `PATH`. You can also point the launcher at a specific Python executable:
+
+```bash
+FLUXHIVE_PYTHON=/path/to/python fluxhive --version
+```
+
+On Windows PowerShell:
+
+```powershell
+$env:FLUXHIVE_PYTHON = "C:\Python312\python.exe"
+fluxhive --version
+```
+
+## Development Install
+
+```bash
+python -m pip install -e .
+npm test
+```
+
+## Quick Start
+
+```bash
+fluxhive config base_url http://127.0.0.1:8001
+fluxhive auth login --username <username>
+
+fluxhive jobs list
+fluxhive agents list
+fluxhive runs list --limit 20
+```
+
+You can also use environment variables:
+
+```bash
+FLUXHIVE_CONTROL_URL=http://127.0.0.1:8001
+FLUXHIVE_ACCESS_TOKEN=<access-token>
+FLUXHIVE_REFRESH_TOKEN=<refresh-token>
+```
+
+## Command Groups
+
+- `auth`: login, refresh tokens, inspect current user, clear local tokens
+- `config`: read and write local CLI configuration
+- `jobs`: create, list, inspect, publish, run, cancel, clone, and delete jobs
+- `runs`: list run attempts, inspect run attempts, print stored run logs
+- `agents`: list agents, inspect GPUs, inspect queues, rename agents
+- `nodes`: alias for `agents`

fluxhive_cli-0.1.0/fluxhive_cli.egg-info/SOURCES.txt

@@ -0,0 +1,23 @@
+LICENSE
+README.md
+pyproject.toml
+fluxhive_cli.egg-info/PKG-INFO
+fluxhive_cli.egg-info/SOURCES.txt
+fluxhive_cli.egg-info/dependency_links.txt
+fluxhive_cli.egg-info/entry_points.txt
+fluxhive_cli.egg-info/top_level.txt
+fluxhivectl/__init__.py
+fluxhivectl/client.py
+fluxhivectl/config.py
+fluxhivectl/context.py
+fluxhivectl/formatting.py
+fluxhivectl/main.py
+fluxhivectl/commands/__init__.py
+fluxhivectl/commands/agents.py
+fluxhivectl/commands/auth.py
+fluxhivectl/commands/config.py
+fluxhivectl/commands/jobs.py
+fluxhivectl/commands/runs.py
+tests/test_client.py
+tests/test_config.py
+tests/test_main.py

fluxhive_cli-0.1.0/fluxhive_cli.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

fluxhive_cli-0.1.0/fluxhive_cli.egg-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+fluxhive = fluxhivectl.main:main
+fluxhivectl = fluxhivectl.main:main

fluxhive_cli-0.1.0/fluxhive_cli.egg-info/top_level.txt

@@ -0,0 +1 @@
+fluxhivectl

fluxhive_cli-0.1.0/fluxhivectl/__init__.py

@@ -0,0 +1,5 @@
+"""FluxHive control-plane CLI package."""
+
+from __future__ import annotations
+
+__version__ = "0.1.0"

fluxhive_cli-0.1.0/fluxhivectl/client.py

@@ -0,0 +1,175 @@
+"""HTTP client for FluxHive Control Server."""
+
+from __future__ import annotations
+
+import json
+import urllib.error
+import urllib.parse
+import urllib.request
+from dataclasses import replace
+from typing import Any
+
+from . import __version__
+from .config import CLIConfig, save_values
+
+
+class ApiError(RuntimeError):
+    def __init__(self, message: str, *, status: int | None = None, code: str | None = None):
+        super().__init__(message)
+        self.status = status
+        self.code = code
+
+    def __str__(self) -> str:
+        parts = []
+        if self.status is not None:
+            parts.append(str(self.status))
+        if self.code:
+            parts.append(self.code)
+        if parts:
+            return f"[{', '.join(parts)}] {super().__str__()}"
+        return super().__str__()
+
+
+class ApiClient:
+    def __init__(self, config: CLIConfig, *, timeout: float = 30.0):
+        self.config = config
+        self.timeout = timeout
+
+    def get(self, path: str, *, query: dict[str, Any] | None = None, auth: bool = True) -> Any:
+        return self.request("GET", path, query=query, auth=auth)
+
+    def post(
+        self,
+        path: str,
+        *,
+        body: dict[str, Any] | None = None,
+        query: dict[str, Any] | None = None,
+        auth: bool = True,
+    ) -> Any:
+        return self.request("POST", path, body=body, query=query, auth=auth)
+
+    def put(self, path: str, *, body: dict[str, Any] | None = None, auth: bool = True) -> Any:
+        return self.request("PUT", path, body=body, auth=auth)
+
+    def patch(self, path: str, *, body: dict[str, Any] | None = None, auth: bool = True) -> Any:
+        return self.request("PATCH", path, body=body, auth=auth)
+
+    def delete(self, path: str, *, auth: bool = True) -> Any:
+        return self.request("DELETE", path, auth=auth)
+
+    def request(
+        self,
+        method: str,
+        path: str,
+        *,
+        body: dict[str, Any] | None = None,
+        query: dict[str, Any] | None = None,
+        auth: bool = True,
+        _retried_after_refresh: bool = False,
+    ) -> Any:
+        url = self._build_url(path, query=query)
+        payload = json.dumps(body).encode("utf-8") if body is not None else None
+        headers = {
+            "Accept": "application/json",
+            "User-Agent": f"fluxhivectl/{__version__}",
+        }
+        if body is not None:
+            headers["Content-Type"] = "application/json"
+        if auth and self.config.access_token:
+            headers["Authorization"] = f"Bearer {self.config.access_token}"
+
+        request = urllib.request.Request(url, data=payload, headers=headers, method=method.upper())
+        try:
+            with urllib.request.urlopen(request, timeout=self.timeout) as response:
+                response_body = response.read()
+                return self._parse_response(response.status, response_body)
+        except urllib.error.HTTPError as exc:
+            response_body = exc.read()
+            if (
+                exc.code == 401
+                and auth
+                and self.config.refresh_token
+                and not _retried_after_refresh
+            ):
+                self._refresh_token()
+                return self.request(
+                    method,
+                    path,
+                    body=body,
+                    query=query,
+                    auth=auth,
+                    _retried_after_refresh=True,
+                )
+            self._raise_api_error(exc.code, response_body)
+        except urllib.error.URLError as exc:
+            raise ApiError(f"Failed to connect to Control Server: {exc.reason}") from exc
+
+    def _build_url(self, path: str, *, query: dict[str, Any] | None = None) -> str:
+        if path.startswith("http://") or path.startswith("https://"):
+            url = path
+        else:
+            url = f"{self.config.api_base_url}/{path.lstrip('/')}"
+        if query:
+            clean_query = {key: value for key, value in query.items() if value is not None}
+            if clean_query:
+                url = f"{url}?{urllib.parse.urlencode(clean_query, doseq=True)}"
+        return url
+
+    def _refresh_token(self) -> None:
+        data = self.request(
+            "POST",
+            "/auth/refresh",
+            body={"refresh_token": self.config.refresh_token},
+            auth=False,
+        )
+        access_token = data.get("access_token")
+        refresh_token = data.get("refresh_token")
+        if not access_token or not refresh_token:
+            raise ApiError("Refresh response did not include tokens", status=401)
+        save_values({"access_token": access_token, "refresh_token": refresh_token})
+        self.config = replace(
+            self.config,
+            access_token=access_token,
+            refresh_token=refresh_token,
+        )
+
+    def _parse_response(self, status: int, response_body: bytes) -> Any:
+        if not response_body:
+            return None
+        try:
+            payload = json.loads(response_body.decode("utf-8"))
+        except json.JSONDecodeError as exc:
+            raise ApiError("Control Server returned invalid JSON", status=status) from exc
+
+        if isinstance(payload, dict) and "success" in payload and "data" in payload:
+            if not payload.get("success"):
+                error = payload.get("error") or {}
+                meta = payload.get("meta") or {}
+                message = error.get("message") or meta.get("message") or "Request failed"
+                code = error.get("code") or meta.get("code")
+                raise ApiError(message, status=status, code=code)
+            return payload.get("data")
+        return payload
+
+    def _raise_api_error(self, status: int, response_body: bytes) -> None:
+        if not response_body:
+            raise ApiError("Request failed", status=status)
+        try:
+            payload = json.loads(response_body.decode("utf-8"))
+        except json.JSONDecodeError as exc:
+            raise ApiError(response_body.decode("utf-8", errors="replace"), status=status) from exc
+
+        if isinstance(payload, dict):
+            error = payload.get("error") or {}
+            meta = payload.get("meta") or {}
+            detail = payload.get("detail")
+            message = (
+                error.get("message")
+                or meta.get("message")
+                or (detail if isinstance(detail, str) else None)
+                or "Request failed"
+            )
+            code = error.get("code") or meta.get("code")
+            raise ApiError(message, status=status, code=code)
+
+        raise ApiError("Request failed", status=status)

fluxhive_cli-0.1.0/fluxhivectl/commands/__init__.py

@@ -0,0 +1,16 @@
+"""Command group registration."""
+
+from __future__ import annotations
+
+import argparse
+
+from . import agents, auth, config, jobs, runs
+
+
+def register_commands(subparsers: argparse._SubParsersAction) -> None:
+    config.register(subparsers)
+    auth.register(subparsers)
+    jobs.register(subparsers)
+    runs.register(subparsers)
+    agents.register(subparsers, name="agents")
+    agents.register(subparsers, name="nodes")