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.pynew file mode 100644index 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.tomlindex 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.pyindex 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 urlsplitimport httpxfrom fastapi import APIRouter, BackgroundTasks, Depends, HTTPException, Request-from fastapi.responses import FileResponse, JSONResponse+from fastapi.responses import FileResponse, HTMLResponse, JSONResponsefrom loguru import loggerfrom 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_versionfrom .dependencies import get_servicesfrom .ports import ApiServices@@ -30,6 +31,8 @@ from .ports import ApiServicesrouter = 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 / filenameif 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.htmlindex 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.pyindex 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_SECRETfrom free_claude_code.config.provider_catalog import PROVIDER_CATALOGfrom free_claude_code.config.server_urls import local_admin_urlfrom free_claude_code.config.settings import Settings+from free_claude_code.core.version import package_versionfrom 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.lockindex 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" },