Skip to content

Use Claude Code, Codex, VSCode, Pi, and OpenCode (and 6 other harnesses) for free (1.3B+ free tokens) from your terminal, app, IDE, or phone, and now from the browser with native browser sessions (multi-harness + multi-model) like OpenClaw (voice supported + ToS friendly)

Python

Version Admin assets with FCC releases (#1615)

Ali Khokhar1110d9278685
diff --git a/e2e/test_admin_assets.py b/e2e/test_admin_assets.py
new file mode 100644
index 00000000..be56b72b
--- /dev/null
+++ b/e2e/test_admin_assets.py
@@ -0,0 +1,34 @@
+"""Rendered contracts for Admin asset generation consistency."""
+
+from urllib.parse import urlsplit
+
+from playwright.sync_api import Error, Page, Request, expect
+
+from free_claude_code.core.version import package_version
+
+
+def test_admin_loads_current_release_assets_before_rendering_dynamic_content(
+ page: Page,
+ admin_base_url: str,
+) -> None:
+ requested_paths: list[str] = []
+ page_errors: list[str] = []
+
+ def record_request(request: Request) -> None:
+ requested_paths.append(urlsplit(request.url).path)
+
+ def record_page_error(error: Error) -> None:
+ page_errors.append(str(error))
+
+ page.on("request", record_request)
+ page.on("pageerror", record_page_error)
+ page.goto(f"{admin_base_url}/admin")
+
+ expect(page.locator('[data-provider="nvidia_nim"]')).to_be_visible()
+
+ versioned_root = f"/admin/assets/{package_version()}"
+ assert f"{versioned_root}/admin.css" in requested_paths
+ assert f"{versioned_root}/admin.js" in requested_paths
+ assert "/admin/assets/admin.css" not in requested_paths
+ assert "/admin/assets/admin.js" not in requested_paths
+ assert page_errors == []
diff --git a/pyproject.toml b/pyproject.toml
index 64b83e0b..e0f1d33f 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
[project]
name = "free-claude-code"
-version = "5.17.2"
+version = "5.17.3"
description = "Local proxy connecting coding agents to OpenAI-compatible AI providers"
readme = "README.md"
requires-python = ">=3.14.0"
diff --git a/src/free_claude_code/api/admin_routes.py b/src/free_claude_code/api/admin_routes.py
index 0da2d0ed..1dc8b476 100644
--- a/src/free_claude_code/api/admin_routes.py
+++ b/src/free_claude_code/api/admin_routes.py
@@ -7,7 +7,7 @@ from urllib.parse import urlsplit
import httpx
from fastapi import APIRouter, BackgroundTasks, Depends, HTTPException, Request
-from fastapi.responses import FileResponse, JSONResponse
+from fastapi.responses import FileResponse, HTMLResponse, JSONResponse
from loguru import logger
from pydantic import BaseModel, Field
@@ -23,6 +23,7 @@ from free_claude_code.config.provider_catalog import (
ProviderAuthKind,
)
from free_claude_code.core.json_types import JsonObject, JsonValue
+from free_claude_code.core.version import package_version
from .dependencies import get_services
from .ports import ApiServices
@@ -30,6 +31,8 @@ from .ports import ApiServices
router = APIRouter()
STATIC_DIR = Path(__file__).resolve().parent / "admin_static"
+_ADMIN_ASSET_VERSION_PLACEHOLDER = "__FCC_VERSION__"
+_ADMIN_ASSET_FILENAMES = frozenset({"admin.css", "admin.js"})
LOCAL_PROVIDER_PATHS = {
"lmstudio": "/models",
"llamacpp": "/models",
@@ -83,23 +86,34 @@ def require_loopback_admin(request: Request) -> None:
raise HTTPException(status_code=403, detail="Admin UI is local-only")
-def _asset_response(filename: str) -> FileResponse:
+def _asset_path(filename: str) -> Path:
path = STATIC_DIR / filename
if not path.is_file():
raise HTTPException(status_code=404, detail="Admin asset not found")
- return FileResponse(path)
+ return path
+
+
+def _asset_response(filename: str) -> FileResponse:
+ return FileResponse(_asset_path(filename))
+
+
+def _admin_page_response() -> HTMLResponse:
+ template = _asset_path("index.html").read_text(encoding="utf-8")
+ return HTMLResponse(
+ template.replace(_ADMIN_ASSET_VERSION_PLACEHOLDER, package_version())
+ )
@router.get("/admin", include_in_schema=False)
-async def admin_page(request: Request):
+def admin_page(request: Request):
require_loopback_admin(request)
- return _asset_response("index.html")
+ return _admin_page_response()
[email protected]("/admin/assets/{filename}", include_in_schema=False)
-async def admin_asset(filename: str, request: Request):
[email protected]("/admin/assets/{version}/{filename}", include_in_schema=False)
+async def admin_asset(version: str, filename: str, request: Request):
require_loopback_admin(request)
- if filename not in {"admin.css", "admin.js"}:
+ if version != package_version() or filename not in _ADMIN_ASSET_FILENAMES:
raise HTTPException(status_code=404, detail="Admin asset not found")
return _asset_response(filename)
diff --git a/src/free_claude_code/api/admin_static/index.html b/src/free_claude_code/api/admin_static/index.html
index 16f90644..913bb671 100644
--- a/src/free_claude_code/api/admin_static/index.html
+++ b/src/free_claude_code/api/admin_static/index.html
@@ -5,7 +5,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>Free Claude Code Admin</title>
<link rel="icon" href="data:," />
- <link rel="stylesheet" href="/admin/assets/admin.css" />
+ <link rel="stylesheet" href="/admin/assets/__FCC_VERSION__/admin.css" />
</head>
<body>
<div class="app-shell">
@@ -85,6 +85,6 @@
</div>
</footer>
</div>
- <script src="/admin/assets/admin.js"></script>
+ <script src="/admin/assets/__FCC_VERSION__/admin.js"></script>
</body>
</html>
diff --git a/tests/api/test_admin.py b/tests/api/test_admin.py
index 71175245..c7325108 100644
--- a/tests/api/test_admin.py
+++ b/tests/api/test_admin.py
@@ -18,6 +18,7 @@ from free_claude_code.config.admin.values import MASKED_SECRET
from free_claude_code.config.provider_catalog import PROVIDER_CATALOG
from free_claude_code.config.server_urls import local_admin_url
from free_claude_code.config.settings import Settings
+from free_claude_code.core.version import package_version
from tests.api.support import create_test_app, provider_manager_for_app, runtime_for_app
@@ -89,12 +90,56 @@ def test_admin_page_is_loopback_only(monkeypatch, tmp_path):
assert remote_client.get("/admin").status_code == 403
+def test_admin_page_uses_installed_version_for_asset_urls(monkeypatch, tmp_path):
+ _set_home(monkeypatch, tmp_path)
+ monkeypatch.setattr(
+ "free_claude_code.api.admin_routes.package_version",
+ lambda: "9.8.7",
+ )
+
+ response = _local_client(create_test_app()).get("/admin")
+
+ assert response.status_code == 200
+ assert 'href="/admin/assets/9.8.7/admin.css"' in response.text
+ assert 'src="/admin/assets/9.8.7/admin.js"' in response.text
+ assert 'href="/admin/assets/admin.css"' not in response.text
+ assert 'src="/admin/assets/admin.js"' not in response.text
+
+
+ ("filename", "media_type"),
+ (("admin.css", "text/css"), ("admin.js", "text/javascript")),
+)
+def test_admin_versioned_assets_serve_packaged_files(
+ monkeypatch,
+ tmp_path,
+ filename,
+ media_type,
+):
+ asset_path = (
+ Path(__file__).resolve().parents[2]
+ / "src"
+ / "free_claude_code"
+ / "api"
+ / "admin_static"
+ / filename
+ )
+ _set_home(monkeypatch, tmp_path)
+ response = _local_client(create_test_app()).get(
+ f"/admin/assets/{package_version()}/{filename}"
+ )
+
+ assert response.status_code == 200
+ assert response.headers["content-type"].startswith(media_type)
+ assert response.content == asset_path.read_bytes()
+
+
@pytest.mark.parametrize(
"path",
(
"/admin",
- "/admin/assets/admin.css",
- "/admin/assets/admin.js",
+ f"/admin/assets/{package_version()}/admin.css",
+ f"/admin/assets/{package_version()}/admin.js",
"/admin/api/config",
),
)
@@ -110,7 +155,22 @@ def test_admin_responses_are_never_cached(monkeypatch, tmp_path, path):
("path", "client_host", "expected_status"),
(
("/admin", "203.0.113.10", 403),
- ("/admin/assets/missing.js", "127.0.0.1", 404),
+ ("/admin/assets/admin.js", "127.0.0.1", 404),
+ (
+ f"/admin/assets/{package_version()}.stale/admin.js",
+ "127.0.0.1",
+ 404,
+ ),
+ (
+ f"/admin/assets/{package_version()}/missing.js",
+ "127.0.0.1",
+ 404,
+ ),
+ (
+ f"/admin/assets/{package_version()}/admin.js",
+ "203.0.113.10",
+ 403,
+ ),
),
)
def test_admin_http_errors_are_never_cached(
diff --git a/uv.lock b/uv.lock
index 6fb03c0c..64af5779 100644
--- a/uv.lock
+++ b/uv.lock
@@ -598,7 +598,7 @@ wheels = [
[[package]]
name = "free-claude-code"
-version = "5.17.2"
+version = "5.17.3"
source = { editable = "." }
dependencies = [
{ name = "aiohttp" },