feat(health): include service version in /health response

Clients can now read ``version`` from the ``/health`` payload to gate
calls to functionality that's only available in newer releases. The
value is sourced from the installed package metadata rather than a
hardcoded string, so the FastAPI app and the health response stay in
sync with the version declared in pyproject.toml.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: Danelegend

code-interpreter/app/main.py

@@ -4,7 +4,9 @@
 import logging
 import subprocess
 from collections.abc import AsyncGenerator
-from contextlib import asynccontextmanager, suppress
+from contextlib import asynccontextmanager
+from contextlib import suppress
+from importlib.metadata import version as _package_version
 from shutil import which
 from typing import Final
 
@@ -25,6 +27,8 @@
 
 logger = logging.getLogger(__name__)
 
+SERVICE_VERSION: Final[str] = _package_version("code-interpreter")
+
 
 def _ensure_docker_image_available() -> None:
     """Ensure the Docker executor image is available locally.
@@ -123,7 +127,7 @@ async def lifespan(app: FastAPI) -> AsyncGenerator[None, None]:
 def create_app() -> FastAPI:
     app = FastAPI(
         title="Code Interpreter API",
-        version="0.1.0",
+        version=SERVICE_VERSION,
         docs_url="/docs",
         redoc_url="/redoc",
         openapi_url="/openapi.json",
@@ -134,7 +138,11 @@ def create_app() -> FastAPI:
     def health() -> HealthResponse:
         """Health check that verifies the executor backend is operational."""
         result = get_executor().check_health()
-        return HealthResponse(status=result.status, message=result.message)
+        return HealthResponse(
+            status=result.status,
+            message=result.message,
+            version=SERVICE_VERSION,
+        )
 
     app.include_router(api_router, prefix="/v1")
     return app

code-interpreter/app/models/schemas.py

@@ -120,6 +120,13 @@ class ListFilesResponse(BaseModel):
 class HealthResponse(BaseModel):
     status: Literal["ok", "error"]
     message: StrictStr | None = None
+    version: StrictStr = Field(
+        ...,
+        description=(
+            "Semver of the running service. Clients can compare against a "
+            "required minimum to detect whether new functionality is available."
+        ),
+    )
 
 
 DEFAULT_SESSION_TTL_SEC = 15 * 60

code-interpreter/tests/integration_tests/test_health.py

@@ -7,7 +7,7 @@
 import pytest
 from fastapi.testclient import TestClient
 
-from app.main import create_app
+from app.main import SERVICE_VERSION, create_app
 from app.services.executor_base import HealthCheck
 from app.services.executor_docker import DockerExecutor
 from app.services.executor_factory import get_executor
@@ -29,6 +29,7 @@ def test_health_returns_ok_when_backend_healthy() -> None:
     body = response.json()
     assert body["status"] == "ok"
     assert body["message"] is None
+    assert body["version"] == SERVICE_VERSION
 
 
 def test_health_returns_error_when_backend_unhealthy() -> None:
@@ -42,6 +43,14 @@ def test_health_returns_error_when_backend_unhealthy() -> None:
     body = response.json()
     assert body["status"] == "error"
     assert body["message"] == "daemon down"
+    assert body["version"] == SERVICE_VERSION
+
+
+def test_health_version_matches_package_metadata() -> None:
+    """The version should come from the installed package, not be hardcoded."""
+    from importlib.metadata import version as package_version
+
+    assert package_version("code-interpreter") == SERVICE_VERSION
 
 
 def _make_completed(returncode: int, stderr: bytes = b"") -> subprocess.CompletedProcess[bytes]: