hedit 0.7.11.dev7__tar.gz → 0.7.11.dev10__tar.gz

{hedit-0.7.11.dev7/hedit.egg-info → hedit-0.7.11.dev10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hedit
-Version: 0.7.11.dev7
+Version: 0.7.11.dev10
 Summary: Multi-agent system for HED annotation generation and validation
 Author-email: Annotation Garden Initiative <info@annotation.garden>
 License-Expression: MIT

{hedit-0.7.11.dev7 → hedit-0.7.11.dev10/hedit.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hedit
-Version: 0.7.11.dev7
+Version: 0.7.11.dev10
 Summary: Multi-agent system for HED annotation generation and validation
 Author-email: Annotation Garden Initiative <info@annotation.garden>
 License-Expression: MIT

{hedit-0.7.11.dev7 → hedit-0.7.11.dev10}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "hedit"
-version = "0.7.11.dev7"
+version = "0.7.11.dev10"
 description = "Multi-agent system for HED annotation generation and validation"
 readme = "PKG_README.md"
 requires-python = ">=3.12"

{hedit-0.7.11.dev7 → hedit-0.7.11.dev10}/src/agents/validation_agent.py

@@ -244,6 +244,27 @@ class ValidationAgent:
 
         return result_dict
 
+    def probe(self, schema_version: str = "8.4.0") -> bool:
+        """Confirm the active validator backend can actually run a validation.
+
+        Validates a known-valid HED string ("Red") through the same backend
+        real requests use. A broken backend (Node missing, hed-javascript not
+        built, schema unavailable) surfaces either as an exception or as a
+        VALIDATOR_INIT_ERROR result, both of which return False here.
+
+        Args:
+            schema_version: Schema version to validate against
+
+        Returns:
+            True only when the backend produced a valid result for "Red"
+        """
+        try:
+            result = self._run_validation("Red", schema_version)
+        except Exception:
+            logger.exception("Validator probe failed")
+            return False
+        return result.is_valid
+
     def _get_or_create_validator(
         self, schema_version: str
     ) -> HedJavaScriptValidator | HedPythonValidator:

{hedit-0.7.11.dev7 → hedit-0.7.11.dev10}/src/api/main.py

@@ -671,6 +671,29 @@ async def audit_logging_middleware(request: Request, call_next):
         raise
 
 
+# A schema loader existing does not prove the JavaScript validator can run
+# (Node missing, hed-javascript not built), so /health runs a real validation
+# through the workflow's backend. The probe spawns a Node subprocess on the
+# JS path, so its result is cached and refreshed at most once per TTL.
+_VALIDATOR_PROBE_TTL_SECONDS = 300.0
+_validator_probe: dict[str, float | bool] = {"functional": False, "checked_at": float("-inf")}
+
+
+async def _validator_functional() -> bool:
+    """Return whether the active validator backend passes a functional probe."""
+    now = time.monotonic()
+    if now - _validator_probe["checked_at"] < _VALIDATOR_PROBE_TTL_SECONDS:
+        return bool(_validator_probe["functional"])
+
+    functional = False
+    if workflow is not None:
+        schema_version = os.getenv("HED_SCHEMA_VERSION", "8.4.0")
+        functional = await asyncio.to_thread(workflow.validation_agent.probe, schema_version)
+    _validator_probe["functional"] = functional
+    _validator_probe["checked_at"] = now
+    return functional
+
+
 @app.get("/health", response_model=HealthResponse)
 async def health_check() -> HealthResponse:
     """Health check endpoint.
@@ -679,7 +702,7 @@ async def health_check() -> HealthResponse:
         Health status and service availability
     """
     llm_available = workflow is not None and _llm_credentials_ok
-    validator_available = schema_loader is not None
+    validator_available = schema_loader is not None and await _validator_functional()
 
     status = "healthy" if (llm_available and validator_available) else "degraded"
 

{hedit-0.7.11.dev7 → hedit-0.7.11.dev10}/src/version.py

@@ -1,6 +1,6 @@
 """Version information for HEDit."""
 
-__version__ = "0.7.11.dev7"
+__version__ = "0.7.11.dev10"
 __version_info__ = (0, 7, 11, "dev")
 
 

{hedit-0.7.11.dev7 → hedit-0.7.11.dev10}/tests/test_validation_agent.py

@@ -428,3 +428,21 @@ class TestGetOrCreateValidatorSchemaVersionWarning:
             validation_agent._get_or_create_validator("8.4.0")
 
         assert not any("reusing cached" in record.message for record in caplog.records)
+
+
+class TestValidationAgentProbe:
+    """Tests for the health-check probe (#27)."""
+
+    @pytest.fixture
+    def validation_agent(self):
+        """Create a validation agent using the Python validator."""
+        loader = HedSchemaLoader()
+        return ValidationAgent(loader, use_javascript=False)
+
+    def test_probe_returns_true_on_working_backend(self, validation_agent):
+        """A functional backend validates "Red" cleanly."""
+        assert validation_agent.probe("8.4.0") is True
+
+    def test_probe_returns_false_on_broken_backend(self, validation_agent):
+        """An unloadable schema version fails the probe instead of raising."""
+        assert validation_agent.probe("not-a-real-version") is False