headroomlabs-ai/headroom · error · ValueError

Invalid {MEMORY_INJECTION_MODE_ENV}={normalized!r}; expected

Error message

Invalid {MEMORY_INJECTION_MODE_ENV}={normalized!r}; expected 'live_zone_tail' or 'disabled'

What it means

Error "Invalid {MEMORY_INJECTION_MODE_ENV}={normalized!r}; expected 'live_zone_tail' or 'disabled'" thrown in headroomlabs-ai/headroom.

Source

Thrown at headroom/proxy/memory_injection_mode_policy.py:19

"""Memory-injection mode resolution policy."""

from __future__ import annotations

from typing import Literal, cast

MEMORY_INJECTION_MODE_ENV = "HEADROOM_MEMORY_INJECTION_MODE"
MEMORY_INJECTION_MODE_DEFAULT: Literal["live_zone_tail", "disabled"] = "live_zone_tail"
MemoryInjectionMode = Literal["live_zone_tail", "disabled"]


def resolve_memory_injection_mode(raw: str | None) -> MemoryInjectionMode:
    """Resolve the active memory-injection routing mode from an optional value."""
    normalized = (raw or "").strip().lower()
    if not normalized:
        return MEMORY_INJECTION_MODE_DEFAULT
    if normalized in ("live_zone_tail", "disabled"):
        return cast(MemoryInjectionMode, normalized)
    raise ValueError(
        f"Invalid {MEMORY_INJECTION_MODE_ENV}={normalized!r}; "
        "expected 'live_zone_tail' or 'disabled'"
    )

View on GitHub (pinned to 322425c43b)

Solutions

1. Set {MEMORY_INJECTION_MODE_ENV} to 'live_zone_tail' or 'disabled'
2. Unset the variable to use the default injection mode

When it happens

Trigger: Raised at startup when the memory injection mode environment variable holds an unrecognized value.

Common situations: See trigger scenarios.

AI-assisted analysis of headroomlabs-ai/headroom@322425c43b (2026-08-15). Data as JSON: /api/errors/01fcaf9f017dd0b8. Report an issue: GitHub.