Add package data for GPU rent and update CLI documentation

- Added package data configuration for the 'gpu_rent' package in pyproject.toml.
- Updated README.md to include usage instructions for Windows and Unix launchers.
- Enhanced CLI documentation in cli.md to reflect new commands and their functionalities.
- Revised setup.md to clarify installation steps and environment setup.
- Improved error handling and command descriptions in the CLI implementation.
- Added new functions for model version handling and flavor resolution in the codebase.
- Updated state management to include additional properties for better tracking.

src/gpu_rent/civitai.py

@@ -6,6 +6,8 @@ from dataclasses import dataclass
 
 import httpx
 
+from gpu_rent.errors import CloudError
+
 ALLOWED_HOSTS = ("civitai.com", "civitai.red", "civitai.green")
 
 
@@ -56,3 +58,51 @@ def probe_me(token: str, host: str, timeout: float = 15.0) -> CivitaiProbe:
         status=response.status_code,
         detail=response.text[:200] or response.reason_phrase,
     )
+
+
+def pick_primary_file(version: dict) -> dict | None:
+    files = version.get("files") or []
+    if not isinstance(files, list):
+        return None
+    for item in files:
+        if isinstance(item, dict) and item.get("primary"):
+            return item
+    for item in files:
+        if not isinstance(item, dict):
+            continue
+        name = str(item.get("name") or "").lower()
+        if "safetensor" in name or name.endswith(".safetensors"):
+            return item
+    for item in files:
+        if isinstance(item, dict):
+            return item
+    return None
+
+
+def fetch_model_version(token: str, host: str, version_id: int, timeout: float = 30.0) -> tuple[str, dict]:
+    """GET /api/v1/model-versions/{id}; one retry on the other Civitai host."""
+    first = _normalize_host(host)
+    order = [first, other_host(first)]
+    last_error = "нет ответа"
+    seen: set[str] = set()
+    for candidate in order:
+        if candidate in seen or candidate not in ALLOWED_HOSTS:
+            continue
+        seen.add(candidate)
+        url = f"https://{candidate}/api/v1/model-versions/{version_id}"
+        try:
+            with httpx.Client(timeout=timeout, follow_redirects=True) as client:
+                response = client.get(url, headers={"Authorization": f"Bearer {token}"})
+        except httpx.HTTPError as exc:
+            last_error = str(exc)
+            continue
+        if response.status_code == 200:
+            data = response.json()
+            if isinstance(data, dict) and pick_primary_file(data):
+                return candidate, data
+            last_error = "пустой files[]"
+            continue
+        last_error = f"HTTP {response.status_code}"
+        if response.status_code not in {404, 400}:
+            break
+    raise CloudError(f"Civitai version {version_id}: {last_error} (хосты {', '.join(seen)})")