ErrLookup › headroomlabs-ai/headroom
headroomlabs-ai/headroom
Compress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server. · Python · 754 source files
Analyzed at 322425c43b on 2026-08-15. 418 documented errors.
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| ccr sqlite backend init failed: {0} | exception | error | compression, zstd, dependency, request-body |
| ccr redis backend init failed: {0} | exception | error | compression, zstd, corrupt-body, request-body |
| ccr backend `{backend}` is not compiled in; rebuild with `-- | exception | error | compression, gzip, corrupt-body, request-body |
| failed to load tokenizer for `{name}`: {source} | exception | error | compression, deflate, zlib, corrupt-body, request-body |
| failed to download `{repo}` from HuggingFace Hub: {source} | exception | error | compression, brotli, dependency, request-body |
| magika session init failed: {0} | exception | error | compression, brotli, corrupt-body, request-body |
| magika inference failed: {0} | exception | error | compression, content-encoding, request-body, headers |
| magika session lock poisoned | exception | error | encoding, utf-8, request-body, compression |
| invalid pipeline config TOML: {0} | exception | error | json, validation, request-body |
| could not read pipeline config file: {0} | exception | error | encoding, utf-8, request-body, compression |
| recommendations file not found: {0} | exception | error | json, validation, request-body |
| recommendations IO error at {path}: {source} | exception | error | configuration, environment-variables, startup |
| recommendations TOML parse error: {0} | exception | warning | security, loopback, http-404, admin-endpoints |
| fixture {} declares transform={} but lives under {} | validation | warning | security, dns-rebinding, host-header, http-404 |
| comparator cache_aligner not implemented (Phase 0) | exception | warning | security, csrf, origin, http-403, browser |
| comparator ccr not implemented (Phase 0) | exception | warning | security, csrf, origin, http-403 |
bedrock_eventstream_parse_failed implausible prelude lengths: total_length={total_length}, headers_length={header | exception | error | configuration, memory, startup, validation |
bedrock_eventstream_crc_mismatch prelude CRC mismatch: expected={expected:#010x} got={got:#010x} | exception | error | configuration, environment-variables, memory, startup |
bedrock_upstream_exception Bedrock stream emitted exception: {payload_preview} | exception | error | bedrock, streaming, upstream, sse, rust |
bedrock_eventstream_missing_event_type Bedrock message missing required `:event-type` header | exception | error | bedrock, eventstream, wire-format, sse, rust |
bedrock_sigv4_failed sigv4 signing failed: {0} | http | error | bedrock, sigv4, auth, aws, rust |
| upstream request failed: {0} | http | error | network, upstream, http, timeout, rust |
| invalid upstream URL: {0} | http | error | config, url, upstream, http, rust |
| compression engine startup failed: {0} | error_code | critical | startup, compression, assets, config, rust |
| metrics encode error: {e} | http | error | prometheus, metrics, observability, encoding, rust |
| metrics response build error: {e} | http | warning | prometheus, metrics, http, unreachable, rust |
| items_json must be JSON: {e} | panic | error | python, json, pyo3, ffi, validation |
| items_json must be a JSON array, got {} | panic | error | python, json, pyo3, ffi, type-mismatch |
| doc_json must be JSON: {e} | panic | error | python, json, pyo3, ffi, validation |
| failed to read simulator config {path}: {source} | console | error | rust, config, io, filesystem |
| simulator config is not valid JSON: {0} | console | error | rust, config, json, serde |
| target_savings must be between 0 and 1 | validation | error | python, validation, savings, range-check |
| any-llm-sdk is required for AnyLLMBackend. Install with: pip | exception | error | python, import, optional-dependency, pip, backend |
| {self.name} backend does not support OpenAI format | exception | error | python, backend, not-implemented, openai-compat |
| {self.name} backend does not support OpenAI streaming | exception | error | python, backend, streaming, not-implemented, openai-compat, sse |
| litellm is required for LiteLLMBackend. Install with: pip in | exception | error | python, import, optional-dependency, litellm, backend |
| Bedrock with temporary credentials (AWS_SESSION_TOKEN) requi | exception | error | python, aws, bedrock, optional-dependency, credentials, fail-fast |
| unknown tool {tool!r}; known: {sorted(tools)} | exception | error | python, registry, tooling, key-error |
| {tool}: distributed via PyPI only; `pip install headroom-ai` | exception | error | python, binaries, pypi, platform-not-supported, packaging |
| {tool}: no prebuilt binary for {plat.key()}; supported: {sup | exception | error | python, binaries, platform, architecture, platform-not-supported |
| offline mode (HEADROOM_BINARIES_OFFLINE=1) but fetch require | exception | error | python, binaries, offline, air-gapped, cache, environment |
| binary cache directory parent is not writable: {dest.parent} | exception | error | python, binaries, filesystem, permissions, containers |
| binary cache directory is not writable: {dest.parent} | exception | error | python, binaries, filesystem, permissions |
| failed to download {final_url} after {attempts} attempts: {e | exception | error | python, binaries, network, download, retry, proxy, mirror |
| sha256 mismatch for {path.name}: expected {expected}, got {g | exception | error | python, binaries, integrity, sha256, security, mirror |
| failed to extract {archive.name}: {e} | exception | error | python, binaries, extraction, archive, corruption, disk-full |
| archive did not contain expected member {member!r} | exception | error | python, binaries, extraction, registry, archive, packaging |
| unknown tool {tool!r} | exception | error | binaries, registry, path-lookup, keyerror |
| No optimizer registered for '{key}'. Available: {available} | exception | error | cache, registry, provider, keyerror, lazy-import |
| Unknown provider: {provider} | validation | error | ccr, batch, provider, dispatch, valueerror |
| MCP SDK not installed. Install with: pip install mcp | exception | error | mcp, optional-dependencies, importerror, ccr |
| Error: Memory eval dependencies not installed. | console | error | cli, evals, optional-dependencies, importerror, system-exit |
| Error: litellm required for --answer-model. Run: pip install | console | error | cli, evals, litellm, optional-dependencies |
| Evaluation interrupted. | console | warning | cli, evals, keyboard-interrupt, cancellation |
| Error: Memory eval V2 dependencies not installed. | console | error | cli, evals, optional-dependencies, importerror, v2 |
| Error: {e} | console | error | cli, learn, model-detection, configuration, fail-fast |
| Error: MCP SDK not installed. | console | error | cli, mcp, optional-dependencies, importerror |
| No agents matched the requested filter. | console | warning | cli, mcp, agent-detection, filter, system-exit |
| Error: MCP dependencies not installed: {e} | console | error | cli, mcp, serve, optional-dependencies, importerror |
| Error: Proxy dependencies not installed. Run: pip install he | console | error | cli, proxy, optional-dependencies, importerror |
| Shutting down... | console | info | cli, proxy, shutdown, keyboard-interrupt, exit-code |
| Memory not found: {memory_id} | validation | error | cli, memory, id-resolution, valueerror |
| Ambiguous ID '{memory_id}'. Matches: {[memory.id[:8] for mem | validation | error | cli, memory, id-resolution, ambiguity, valueerror |
| Memories {old_memory.id} and {new_memory.id} do not form a r | validation | error | cli, memory, supersession, data-integrity, valueerror |
| {_WRAP_PROXY_TIMEOUT_ENV} must be a positive integer number | validation | error | cli, wrap, environment-variable, configuration, runtimeerror |
| No available port found in range {start_port}-{end_port - 1} | exception | error | network, ports, resource-exhaustion, headroom, cli |
| Proxy exited with code {proc.returncode}: {tail} | exception | critical | proxy, startup, subprocess, logging, headroom, cli |
| Proxy failed to start on port {port} within {timeout_seconds | exception | error | timeout, proxy, startup, performance, environment-variables, headroom |
| Proxy process exited unexpectedly. | console | critical | proxy, process-crash, monitoring, logging, headroom, cli |
| Error: {e} | console | error | error-handling, catch-all, cli, headroom, diagnostics |
| Error: 'claude' not found in PATH. | console | error | path, installation, claude-code, cli, headroom |
| Error: 'copilot' not found in PATH. | console | error | path, installation, github-copilot, cli, headroom |
| Error: Copilot BYOK mode requires a provider API key. `headr | console | error | authentication, api-key, byok, github-copilot, environment-variables, headroom |
| Error: '--model auto' is not supported in Copilot BYOK mode. | console | error | byok, model-selection, github-copilot, validation, headroom, cli |
| Error: 'codex' not found in PATH. | console | error | path, installation, codex, cli, headroom |
| Error: 'aider' not found in PATH. | console | error | path, installation, aider, python, cli, headroom |
| Error: 'openclaude' not found in PATH. | console | error | path, installation, openclaude, cli, headroom |
| Error: 'vibe' not found in PATH. | console | error | path, installation, vibe, mistral, cli, headroom |
| Error: 'kimi' (or 'kimi-cli') not found in PATH. | console | error | path, installation, kimi, moonshot, cli, headroom |
| Error: 'grok' not found in PATH. | console | error | path, installation, grok, xai, cli, headroom |
| Error: 'goose' not found in PATH. | console | error | path, installation, goose, rust, cli, headroom |
| Error: 'openhands' not found in PATH. | console | error | cli, path, dependency, openhands, wrap |
| Error: 'opencode' not found in PATH. | console | error | cli, path, dependency, opencode, wrap, config-safety |
| Error: 'omp' not found in PATH. | console | error | cli, path, dependency, omp, oh-my-pi, wrap |
| Magika is required for ML-based content detection. Install w | exception | error | dependency, import, ml, content-detection, python |
| Copilot OAuth token must not be empty. | validation | error | validation, auth, copilot, oauth, token |
| GitHub device authorization returned an invalid response. | exception | error | network, auth, oauth, github, device-flow, proxy |
| GitHub device authorization expired. | exception | error | auth, oauth, github, device-flow, timeout, expiration |
| GitHub device authorization failed: {description} | exception | error | auth, oauth, github, device-flow, access-denied |
| No GitHub Copilot OAuth token is available. | exception | error | auth, copilot, oauth, cache, credentials |
| Copilot token exchange returned an empty token. | exception | error | auth, copilot, token-exchange, entitlement, subscription |
| Copilot token exchange failed with HTTP {exc.code}: {body} | exception | error | auth, copilot, http, token-exchange, network |
| position must be one of {POSITIONS}, got {position!r} | exception | error | validation, evals, adversarial, python, input-validation |
| anthropic package required. Install with: pip install anthro | exception | error | dependency, import, evals, anthropic, llm |
| openai package required. Install with: pip install openai | exception | error | dependency, import, evals, openai, llm |
| Unknown provider: {self.provider} | exception | error | validation, evals, llm, provider, config |
| lm-eval failed: {result.stderr} | exception | error | subprocess, benchmark, lm-eval, evals, harness |
| OPENAI_API_KEY environment variable required | exception | error | config, environment, api-key, benchmark, evals |
| HuggingFace datasets required for this loader. Install with: | exception | error | dependency, import, evals, datasets, huggingface, extras |
| Failed to load LongBench task '{task}': {e} | exception | error | |
| Failed to load multi-wiki-qa '{lang}': {e} | exception | error | |
| Failed to download BFCL dataset '{data_file}': {e} | exception | error | |
| Failed to load ToolBench category '{category}': {e} | exception | error | |
| Failed to load CodeSearchNet for '{language}': {e} | exception | error | |
| Unknown dataset '{name}'. Available: {available} | exception | error | |
| OpenAI package required. Install with: pip install openai | exception | error | |
| Anthropic package required. Install with: pip install anthro | exception | error | |
| LiteLLM package required. Install with: pip install litellm | exception | error | |
| HuggingFace datasets required. Install with: pip install dat | exception | error | |
| HuggingFace datasets required | exception | error | |
| Unknown dataset: {dataset_name} | exception | error | |
| No valid samples processed | exception | error | |
| OpenAI package required for LLM judge. Install with: pip ins | exception | error | |
| Anthropic package required for LLM judge. Install with: pip | exception | error | |
| LiteLLM package required for LLM judge. Install with: pip in | exception | error | |
| Memory system not initialized | exception | error | |
| sentence-transformers required for semantic similarity. Inst | exception | error | |
| OpenAI package required for prompt comparison. Install with: | exception | error | |
| OpenAI API key required. Set OPENAI_API_KEY environment vari | exception | error | openai, api-key, configuration, evals, llm-judge |
| Headroom modified prompt semantics! Differences: {result.dif | exception | error | semantics, llm-judge, evals, prompt-preservation, regression |
| anthropic package required. Install with: pip install anthro | exception | error | anthropic, import-error, optional-dependency, evals, configuration |
| openai package required. Install with: pip install openai | exception | error | openai, import-error, optional-dependency, evals, configuration |
| ollama package required. Install with: pip install ollama | exception | error | ollama, import-error, optional-dependency, evals, local-llm |
| Unknown provider: {self.llm_config.provider} | exception | error | configuration, validation, provider, evals, typo |
| Unknown compression-only benchmark: {spec.name} | exception | error | validation, suite-config, evals, naming, typo |
| Unsupported platform: {system} {machine} | exception | error | platform, installer, binary, unsupported-os, environment |
| Invalid URL: {url} | exception | warning | url-validation, installer, defensive-check, configuration |
| Failed to download codebase-memory-mcp from {url}: {e} | exception | error | network, download, installer, github, wrapping |
| codebase-memory-mcp binary not found in archive | exception | error | installer, archive, packaging, download, mismatch |
| Failed to extract archive: {e} | exception | error | installer, archive, corruption, network, extraction |
| Windows environment mutation is missing a variable name | validation | error | windows, manifest, rollback, corruption, internal-state |
| Windows environment mutation is missing a valid scope | validation | error | windows, manifest, rollback, validation, schema |
| deployment profile '{profile}' is corrupt ({path}): {e} | exception | error | manifest, corruption, installation, persistence, schema-drift |
| Agno is required for this integration. Install with: pip ins | exception | error | agno, import-error, optional-dependency, integration, feature-flag |
| httpx is required for Headroom Cloud mode: pip install httpx | exception | error | httpx, import-error, optional-dependency, asgi, cloud, lazy-import |
| AutoGen is required for this integration. Install with: pip | exception | error | autogen, import-error, optional-dependency, integration, package-naming |
| CrewAI is required for this integration. Install with: pip i | exception | error | crewai, import-error, optional-dependency, integration, dependency-conflict |
| LangChain is required for this integration. Install with: pi | exception | error | langchain, import-error, optional-dependency, integration, extras |
| LangChain is required for this integration. Install with: pi | exception | error | langchain, import-error, optional-dependency, installation |
| LangChain is required for this integration. Install with: pi | exception | error | langgraph, langchain, import-error, optional-dependency |
| LangChain is required for this integration. Install with: pi | exception | error | langsmith, langchain, telemetry, import-error |
| LangChain is required for this integration. Install with: pi | exception | error | memory, langchain, import-error, chat-history |
| LangChain is required for this integration. Install with: pi | exception | error | retriever, rag, langchain, import-error |
| LangChain is required for this integration. Install with: pi | exception | error | streaming, langchain, import-error, notebook-pitfall |
| httpx is required for Headroom Cloud mode: pip install httpx | exception | error | httpx, litellm, cloud, import-error, lazy-import |
| Strands SDK is required for this integration. Install with: | exception | error | strands, aws, import-error, optional-dependency |
| Strands SDK is required for this integration. Install with: | exception | error | strands, model-wrapper, import-error, optional-dependency |
| HEADROOM_LEARN_CLI={cli_override!r} is not a supported CLI. | validation | error | configuration, env-var, cli, validation |
| No LLM API key found. headroom learn needs one of: export | exception | critical | configuration, api-key, env-var, cli, bootstrap |
| Unknown CLI model: {model} | validation | error | internal, model-selection, cli, validation |
| `{cmd[0]}` not found in PATH. Install it or use a different | exception | error | path, cli, subprocess, environment |
| `{' '.join(cmd)}` did not respond within {hard_cap}s. Check | exception | error | timeout, cli, subprocess, configuration |
| `{' '.join(cmd)}` failed (exit {result.returncode}): {stderr | exception | error | cli, exit-code, subprocess, auth |
| `{' '.join(cmd)}` returned unparseable output. First {_MAX_S | exception | error | json-parsing, cli, llm-output, retryable |
| `{' '.join(cmd)}` exceeded the {hard_cap}s hard cap. Raise H | exception | error | timeout, claude-cli, streaming, watchdog, configuration |
| `{' '.join(cmd)}` produced no output for {idle_cap}s. Check | exception | error | network, timeout, cli, learn, subprocess |
| `{' '.join(cmd)}` failed (exit {proc.returncode}): {stderr_b | exception | error | cli, subprocess, exit-code, learn, auth |
| `{' '.join(cmd)}` did not emit a final `result` event. First | exception | error | cli, streaming, protocol, learn, json |
| `{' '.join(cmd)}` returned unparseable output. First {_MAX_S | exception | error | llm, json, parsing, learn, model-output |
| Unknown agent: {name!r}. Available: {available} | exception | error | plugin, registry, learn, configuration |
| module {__name__!r} has no attribute {name!r} | exception | error | python, import, lazy-loading, memory, attributeerror |
| module {__name__!r} has no attribute {name!r} | exception | error | python, import, lazy-loading, adapters, memory |
| max_size must be at least 1, got {max_size} | validation | error | validation, configuration, cache, memory, valueerror |
| sentence-transformers is required for LocalEmbedder. Install | exception | error | dependencies, import, embeddings, memory, optional-extra |
| OpenAI API key required. Provide api_key parameter or set OP | validation | error | configuration, auth, api-key, embeddings, memory |
| openai is required for OpenAIEmbedder. Install it with: pip | exception | error | dependencies, import, embeddings, memory, optional-extra |
| OpenAI API error: {e} | exception | error | api, openai, embeddings, non-retryable, network |
| OpenAI API failed after {self._max_retries} retries: {last_e | exception | error | api, openai, retry, rate-limit, embeddings, network |
| httpx is required for OllamaEmbedder. Install it with: pip i | exception | error | dependencies, import, ollama, embeddings, memory |
| Ollama API error: {e} | exception | error | ollama, api, embeddings, non-retryable, local-model |
| Ollama API failed after {self._max_retries} retries: {last_e | exception | error | ollama, retry, network, embeddings, local-model |
| memory_ids ({len(memory_ids)}) and texts ({len(texts)}) must | validation | error | validation, batch, fts5, memory, invariant |
| metadata ({len(metadata)}) must match memory_ids ({len(memor | validation | error | validation, batch, fts5, memory, invariant |
| hnswlib is required for HNSWVectorIndex. Install with: pip i | exception | error | dependencies, native, vector-index, hnsw, memory |
| save_path must be provided when auto_save is True | validation | error | validation, configuration, vector-index, persistence, memory |
| Memory {memory.id} has no embedding | validation | error | hnsw, embedding, validation, vector-index |
| Embedding dimension {embedding.shape[0]} does not match inde | validation | error | hnsw, dimension-mismatch, embedding, validation |
| query_text provided but HNSWVectorIndex does not embed text. | validation | error | hnsw, search, query-text, validation |
| Either query_vector or query_text must be provided | validation | error | hnsw, search, validation, missing-argument |
| Query vector dimension {query_vector.shape[0]} does not matc | validation | error | hnsw, search, dimension-mismatch, validation |
| HNSW index not found: {hnsw_path} | exception | error | hnsw, persistence, file-not-found, load |
| Metadata file not found: {meta_path} | exception | error | hnsw, persistence, file-not-found, metadata |
| Saved index dimension {saved_dimension} does not match curre | validation | error | hnsw, dimension-mismatch, persistence, load |
| Memory with ID {old_memory_id} not found | validation | error | sqlite, supersession, lineage, not-found |
| A memory cannot supersede itself | validation | error | sqlite, supersession, self-reference, validation |
| Memory {old_memory_id} not found | validation | error | sqlite, supersession, not-found, transactions |
| Memory {new_memory_id} not found | validation | error | sqlite, supersession, not-found, data-integrity |
| Memories {old_memory_id} and {new_memory_id} do not form a r | validation | error | sqlite, supersession, data-integrity, validation |
| sqlite-vec is required for SQLiteVectorIndex. Install with: | exception | critical | sqlite-vec, import-error, environment, optional-dependency |
| Memory {memory.id} has no embedding | validation | error | sqlite-vec, embedding, validation, vector-index |
| Embedding dimension {embedding.shape[0]} does not match inde | validation | error | sqlite-vec, dimension-mismatch, embedding, validation |
| query_text provided but SQLiteVectorIndex does not embed tex | validation | error | sqlite-vec, search, query-text, validation |
| query_vector must be provided | validation | error | sqlite-vec, search, missing-argument, validation |
| Query dimension {query_vector.shape[0]} does not match index | validation | error | sqlite-vec, search, dimension-mismatch, validation |
| openai package not installed. Install with: pip install open | exception | error | python, import, dependency, openai, mem0, memory-backend |
| qdrant-client not installed. Install with: pip install qdran | exception | error | python, import, dependency, qdrant, mem0, memory-backend |
| mem0 package not installed. Install with: pip install 'headr | exception | error | python, import, dependency, mem0, memory-stack, memory-backend |
| Failed to update memory: {e} | exception | error | python, mem0, update, valueerror, runtime-wrap, memory-backend |
| Timed out waiting for DirectMem0 background writes: {pending | exception | error | python, asyncio, timeout, shutdown, background-tasks, mem0 |
| mem0 package not installed. Install with: pip install 'headr | exception | error | python, import, dependency, mem0, memory-backend |
| api_key is required for cloud mode | exception | error | python, mem0, config, api-key, authentication, validation |
| Memory not found: {memory_id} | exception | error | python, mem0, not-found, update, valueerror, memory-backend |
| Cannot update memories belonging to other users | exception | error | python, mem0, authorization, ownership, multi-tenant, validation |
| Failed to update memory: {e} | exception | error | python, mem0, update, valueerror, runtime-wrap, retryable |
| default_importance must be 0.0-1.0, got {self.default_import | validation | error | python, config, validation, range-check, importance, memory-bridge |
| dedup_similarity_threshold must be 0.0-1.0, got {self.dedup_ | validation | error | python, config, validation, range-check, dedup, memory-bridge |
| vector_dimension must be positive, got {self.vector_dimensio | validation | error | python, config, validation, vector, embeddings, range-check |
| hnsw_ef_construction must be positive, got {self.hnsw_ef_con | validation | error | python, config, validation, hnsw, vector-index, range-check |
| hnsw_m must be positive, got {self.hnsw_m} | validation | error | python, config, validation, hnsw, vector-index, range-check |
| hnsw_ef_search must be positive, got {self.hnsw_ef_search} | validation | error | python, config, validation, hnsw, vector-index, range-check |
| cache_max_size must be positive, got {self.cache_max_size} | validation | error | python, config, validation, cache, range-check |
| openai_api_key is required when using OpenAI embedder backen | validation | error | python, config, openai, api-key, embeddings, validation |
| Memory {old_memory_id} not found | exception | error | python, memory, not-found, supersede, valueerror, validation |
| qdrant-neo4j backend requires additional packages. Install w | exception | error | python, import, dependency, mem0, qdrant, neo4j, docker, memory-stack |
| Unknown backend: {self._backend_type} | validation | error | memory, configuration, validation |
| {field_name} is required when backend is EXTERNAL; set it to | validation | error | memory, configuration, plugins, entry-points |
| Unknown store backend: {config.store_backend} | validation | error | memory, configuration, enums, version-drift |
| openai_api_key is required for OpenAI embedder | validation | error | memory, embeddings, openai, credentials, configuration |
| Unknown embedder backend: {config.embedder_backend} | validation | error | memory, embeddings, enums, configuration |
| Model '{model}' does not have batch output pricing | validation | error | pricing, batch-api, validation |
| module {__name__!r} has no attribute {name!r} | exception | error | imports, lazy-loading, attributeerror |
| tiktoken is required for OpenAI provider. Install with: pip | exception | error | dependency, installation, tokenizer, openai, python |
| Headroom OpenCode wrap blocked direct HTTP/2 connection to $ | exception | error | proxy, nodejs, http2, opencode, monkey-patching |
| Headroom OpenCode transport shim loaded without HEADROOM_OPE | exception | error | environment, configuration, nodejs, opencode, proxy |
| {env_var} must be a JSON object of header name/value strings | validation | error | configuration, json, headers, environment, cli |
| Unsupported api_style: {api_style} | validation | error | configuration, provider, dispatch, python |
| module {__name__!r} has no attribute {name!r} | exception | error | python, import, lazy-loading, api-surface |
| Invalid {BETA_HEADER_STICKY_ENV}={normalized!r}; expected 'e | validation | error | configuration, environment, validation, beta-headers |
| Invalid {BETA_TRACKER_MAX_SESSIONS_ENV}={normalized!r}; expe | validation | error | configuration, environment, validation, parsing |
| max_sessions must be > 0 | validation | error | validation, constructor, lru, python |
| provider must be non-empty | validation | error | validation, session, provider, tracker |
| session_id must be non-empty | validation | error | validation, session, tracker, headers |
| Invalid {TRUSTED_DASHBOARD_CLIENT_CIDRS_ENV} entry: {exc} | validation | error | configuration, network, cidr, validation, security |
| Rate limited. Retry after {wait_seconds:.1f}s | http | warning | rate-limit, http-429, proxy, retry-after, throttling |
| Budget exceeded for {budget_period} period | http | error | budget, cost-control, http-429, proxy, spend-limit |
| Rate limited. Retry after {wait_seconds:.1f}s | http | warning | rate-limit, http-429, gemini, proxy, api-key |
| max_sessions must be > 0 | validation | error | validation, constructor, lru, beta-headers, configuration |
| Request body is zstd-compressed but the 'zstandard' package | validation | error | |
| Failed to decompress zstd request body: {exc} | validation | error | |
| Failed to decompress gzip request body: {exc} | validation | error | |
| Failed to decompress deflate request body: {exc} | validation | error | |
| Request body is brotli-compressed but the 'brotli' package i | validation | error | |
| Failed to decompress brotli request body: {exc} | validation | error | |
| Unsupported Content-Encoding: {encoding} | validation | error | |
| Request body is not valid UTF-8 (possibly compressed?): {exc | validation | error | |
| Request body must be a JSON object, not " + type(result).__n | validation | error | |
| Invalid {STRIP_INTERNAL_HEADERS_ENV}={normalized!r}; expecte | validation | error | |
| Not Found | http | error | |
| cross-origin request rejected | http | error | |
| Unknown memory backend: {self.config.backend} | validation | error | |
| Path traversal detected: {path} | validation | error | |
| Invalid {MEMORY_INJECTION_MODE_ENV}={normalized!r}; expected | validation | error | |
| worker_processes must be >= 1 | validation | error | |
| retry_max_attempts must be >= 1 when retry_enabled=True | validation | error | config, validation, retries |
| rate_limit_requests_per_minute must be >= 1 when rate_limit_ | validation | error | config, validation, rate-limit |
| Invalid {PYTHON_FORWARDER_MODE_ENV}={normalized!r}; expected | validation | error | env, config, validation |
| {SSE_EVENT_MAX_BYTES_ENV} must be an integer, got {raw!r} | validation | error | env, validation, sse |
| {SSE_EVENT_MAX_BYTES_ENV} must be positive, got {value} | validation | error | env, validation, sse |
| {BODY_TOO_LARGE_STATUS_ENV} must be an integer, got {raw!r} | validation | error | env, validation, http |
| {BODY_TOO_LARGE_STATUS_ENV} must be a 4xx/5xx status, got {v | validation | error | env, validation, http |
| Invalid memory_mode={config.memory_mode!r}; expected one of | validation | error | config, enum, validation |
| Invalid memory_storage_mode={config.memory_storage_mode!r}; | validation | error | config, enum, validation |
| FastAPI required. Install: pip install fastapi uvicorn httpx | exception | error | dependencies, import, server |
| Not Found | http | error | http, authorization, network |
| hash required | http | error | http, validation, retrieval |
| format_retrieval_miss_detail(entry_status) | http | warning | http, cache, retrieval |
| format_retrieval_miss_detail(store.get_entry_status(hash_key | http | warning | http, cache, race-condition |
| No telemetry found for signature: {signature_hash} | http | info | http, telemetry, not-found |
| No TOIN pattern found with hash starting with: {hash_prefix} | http | info | http, toin, not-found |
| Invalid tool call or not a {CCR_TOOL_NAME} call | http | error | http, validation, tool-call |
| workers must be >= 1 | validation | error | config, validation, server |
| Invalid {TOOL_INJECTION_STICKY_ENV}={normalized!r}; expected | validation | error | configuration, environment, validation, proxy |
| Invalid {TOOL_TRACKER_MAX_SESSIONS_ENV}={normalized!r}; expe | validation | error | configuration, environment, validation, lru-cache |
| Invalid semantic version: {value} | validation | error | versioning, release, validation |
| Unsupported bump level: {level} | exception | error | versioning, release, validation |
| Invalid release tag: {tag} | exception | error | versioning, release, validation, git |
| EmbeddingScorer requires sentence-transformers. Install with | exception | error | dependencies, optional-feature, relevance, installation |
| Unknown scorer tier: {tier}. Valid tiers: {valid_tiers} | exception | error | validation, arguments, relevance |
| numpy is required for EmbeddingScorer. Install with: pip ins | exception | error | dependencies, optional-feature, numpy, lazy-import |
| EmbeddingScorer requires fastembed. Install with: pip instal | exception | error | dependencies, optional-feature, fastembed, lazy-import |
| jinja2 is required for report generation. Install with: pip | exception | error | dependencies, optional-feature, jinja2, reporting, lazy-import |
| unknown rollout channel {value!r} | exception | error | configuration, rollout, validation, enum |
| invalid rollout worker snapshot | exception | error | serialization, rollout, validation, worker-handoff |
| unsupported rollout worker schema version | exception | error | versioning, serialization, rollout, worker-handoff |
| rollout worker policy version mismatch | exception | error | versioning, rollout, policy, worker-handoff |
| invalid rollout worker unsafe override | exception | error | serialization, rollout, type-validation, boolean |
| invalid rollout worker field {field!r} | exception | error | serialization, rollout, type-validation, lists |
| rollout worker registry digest mismatch | exception | error | integrity, rollout, digest, worker-handoff |
| rollout worker snapshot digest mismatch | exception | error | integrity, rollout, digest, worker-handoff |
| unknown rollout feature(s) in {source}: {', '.join(unknown)} | exception | error | rollout, configuration, feature-flags |
| conflicting values supplied for {source_keys[key]!r} and {in | validation | error | settings, configuration, conflict |
| expected a boolean, got {value!r} | validation | error | settings, validation, boolean |
| expected a number, got {value!r} | validation | error | settings, validation, types |
| expected an integer, got {value!r} | validation | error | settings, validation, numbers |
| expected a finite number, got {value!r} | validation | error | settings, validation, numbers, edge-case |
| must be >= {field.minimum} | validation | error | settings, validation, range |
| must be <= {field.maximum} | validation | error | settings, validation, range |
| {token!r} not one of {list(field.choices)} | validation | error | settings, validation, enum |
| expected a JSON object of header name/value strings | validation | error | settings, json, headers |
| settings validation failed: unknown={unknown_keys} errors={f | validation | error | settings, validation, api |
| A tracker with key '{tracker.key}' is already registered. Ea | exception | error | subscription, quota, registry, uniqueness |
| deployment env missing {self.config_env_var} | exception | error | testing, deployment, environment |
| {self.config_env_var} does not match config_payload | exception | error | testing, deployment, configuration, drift |
| {cls!r} must be a dataclass | exception | error | testing, dataclass, types |
| mode must be 'token' or 'cache' | exception | error | testing, harness, validation, enum |
| {name} is read-only; mutate its fields instead | exception | warning | testing, harness, api-misuse |
| unknown Headroom harness config field: {name} | exception | warning | testing, harness, api-misuse, typo |
| unknown ProxyConfig field: {key} | exception | warning | testing, harness, builder, typo |
| unknown HeadroomConfig field: {key} | exception | error | config, sdk, fluent-api, typo |
| duplicate scenario name in suite: {built.name} | exception | error | testing, harness, duplicates, config |
| HeadroomSuite requires at least one scenario | exception | error | testing, harness, validation, empty-input |
| unsupported headroom-bench proxy mode: {raw_mode!r} | exception | error | benchmark, config, proxy, validation |
| headroom proxy exited with code {self._process.returncode} | exception | critical | process, proxy, startup, subprocess, ci |
| headroom proxy was not ready at {url}: {last_error} | exception | error | timeout, proxy, startup, network, ci |
| ScenarioOrchestrator requires at least one scenario | exception | error | testing, validation, empty-input, orchestrator |
| ScenarioOrchestrator.run requires at least one task | exception | error | testing, validation, empty-input, fixtures |
| {self.__class__.__name__} does not support encoding | exception | warning | tokenizer, capability, not-implemented, dependencies |
| {self.__class__.__name__} does not support decoding | exception | warning | tokenizer, capability, not-implemented, dependencies |
| Encoding not available for {self.model} - tokenizer {self.to | exception | warning | tokenizer, huggingface, fallback, network, not-implemented |
| Decoding not available for {self.model} - tokenizer {self.to | exception | warning | tokenizer, huggingface, fallback, network, not-implemented |
| mistral-common is required for MistralTokenizer. Install wit | exception | error | tokenizer, mistral, dependencies, optional-import |
| No tokenizer available for {model}: {e} | exception | error | tokenizer, registry, fallback, dependencies |
| Must provide either tokenizer or factory | exception | error | registry, validation, api-misuse |
| Unknown backend: {backend} | exception | error | registry, backend, api-misuse, typo |
| tiktoken encoding {encoding_name!r} previously failed to loa | exception | error | tokenizer, tiktoken, network, timeout, caching |
| tiktoken encoding {encoding_name!r} load timed out | exception | error | tokenizer, tiktoken, timeout, network, caching, ci |
| module {__name__!r} has no attribute {name!r} | exception | error | imports, lazy-loading, api-misuse, typo |
| Language '{language}' is quarantined for code-aware compress | exception | error | tree-sitter, language-support, validation, code-compression |
| tree-sitter is not installed. Install with: pip install head | exception | error | dependency, import-error, tree-sitter, installation |
| Language '{language}' is not supported by tree-sitter. Suppo | exception | error | tree-sitter, language-support, validation |
| min_batch_bytes must be positive | exception | error | validation, configuration, batching |
| max_batch_bytes must be at least min_batch_bytes | exception | error | validation, configuration, batching |
| max_batch_units must be positive | exception | error | validation, configuration, batching |
| Unhandled AuthMode variant: {mode!r} | exception | error | enum, policy, validation, exhaustiveness |
| compressor descriptor.name must be non-empty | exception | error | registry, validation, configuration |
| compressor {name!r} is already registered | exception | error | registry, duplicate, plugin |
| unserializable config value: {type(value).__name__} | exception | error | serialization, toml, json, configuration |
| native detect_content_type exceeded {timeout:.1f}s watchdog | exception | warning | timeout, watchdog, native, rust, content-detection |
| unknown importance context: {context} | exception | error | validation, rust, pyo3, error-detection |
| {model_id} | exception | error | model-loading, cache, offline, huggingface |
| No loadable ONNX artifact in {model_id}; tried {_onnx_filena | exception | error | onnx, onnxruntime, model-loading, network, huggingface |
| answerdotai/ModernBERT-base | exception | error | tokenizer, cache, offline, huggingface, transformers |
| merged.pt for {model_id} is missing {missing_sections}; foun | exception | error | pytorch, checkpoint, model-loading, cache |
| {model_id} {section}: state_dict mismatch against {type(subm | exception | error | pytorch, state-dict, version-skew, model-loading |
| {model_id} model.safetensors: state_dict mismatch against He | exception | critical | safetensors, state-dict, model-loading, architecture-mismatch |
| Kompress requires onnxruntime or torch. Install with: pip in | exception | error | dependency, import-error, onnx, pytorch, installation |
| target_ratio list length {len(target_ratio)} does not match | validation | error | validation, batch-api, kompress, precondition |
| ccr_originals list length {len(ccr_originals)} does not matc | validation | error | validation, batch-api, kompress, ccr, precondition |
| remote Kompress response field 'compressed' must be a string | validation | error | network, api-contract, json, kompress, remote-backend |
| model_limit is required. Provide it via kwargs or configure | validation | error | configuration, pipeline, model-limits, precondition |
| SmartCrusher: custom `relevance_config` / `scorer` overrides | exception | error | not-implemented, rust-port, breaking-change, smart-crusher |
| unknown compaction format {resolved_format!r}; expected one | validation | error | configuration, env-vars, validation, smart-crusher |
| SmartCrusher: invalid protected_patterns regex {p!r}: {e} | validation | error | regex, validation, smart-crusher, protected-patterns |
| Reading .xlsx files requires openpyxl. Install it with: pip | exception | error | dependencies, optional-extras, spreadsheet, importerror |
| Reading legacy .xls files requires xlrd. Install it with: pi | exception | error | dependencies, optional-extras, spreadsheet, legacy-formats, importerror |
| Spreadsheet not found: {p} | exception | error | filesystem, validation, precondition, spreadsheet |
| Unsupported spreadsheet format '{suffix}'. Supported: .xlsx, | validation | error | validation, file-format, spreadsheet, precondition |
| {key}={raw!r} is not an integer | validation | error | configuration, env-vars, oauth2, fail-closed |
| headroom-oauth2 misconfigured: {e} | exception | critical | oauth2, configuration, plugin, fail-closed, startup |
| token_url is required | validation | error | oauth2, validation, configuration, precondition |
| client_id and client_secret are required | validation | error | oauth2, validation, secrets, configuration |
| auth_style must be 'post' or 'basic' | validation | error | oauth2, validation, configuration, env-vars |
| token_url must be https (loopback http allowed for tests; se | validation | error | oauth2, security, tls, configuration |
| token endpoint returned HTTP {e.code} | exception | error | oauth2, network, http, identity-provider |
| token endpoint unreachable: {e} | exception | error | oauth2, network, dns, timeout, retryable |
| token endpoint returned non-JSON | exception | error | oauth2, api-contract, json, identity-provider |
| token endpoint response had no access_token | exception | error | oauth2, authentication, configuration, network |
| Headroom proxy startup is disabled | exception | error | proxy, configuration, typescript, openclaw |
| Service reachable at ${explicitUrl}, but it does not appear | exception | error | proxy, configuration, port-conflict, openclaw |
| Remote Headroom proxy not reachable at ${explicitUrl}. Ensur | exception | error | proxy, network, remote, configuration, openclaw |
| Cannot auto-start Headroom at ${startupUrl}: port is in use | exception | error | proxy, port-conflict, auto-start, openclaw |
| Attempted to start Headroom proxy, but it was not reachable | exception | error | proxy, auto-start, timeout, openclaw |
| Headroom proxy not reachable at ${explicitUrl}. Ensure the p | exception | error | proxy, configuration, openclaw |
| Headroom proxy not detected on default endpoints (${defaultC | exception | error | proxy, configuration, setup, openclaw |
| proxyPort must be an integer between 1 and 65535 | validation | error | proxy, configuration, validation, openclaw |
| No usable Headroom launcher found. Tried PATH, local npm, gl | exception | error | proxy, installation, auto-start, environment, openclaw |
| Invalid proxyUrl: "${proxyUrl}" | validation | error | proxy, url, validation, openclaw |
| proxyUrl must use http:// or https:// | validation | error | proxy, url, validation, openclaw |
| proxyUrl must not include a path, query, or hash | validation | error | proxy, url, validation, openclaw |
| Headroom OpenCode transport shim loaded without HEADROOM_OPE | exception | error | environment, configuration, opencode, plugin, module-load |
| Headroom OpenCode transport shim loaded without HEADROOM_OPE | exception | error | environment, configuration, opencode, plugin, pip |
| Headroom OpenCode wrap blocked direct HTTP/2 connection to $ | exception | error | http2, transport, proxy, opencode, typescript |
| neither `objdump` nor `llvm-objdump` is on PATH; install bin | exception | error | tooling, ci, python, packaging, environment |
| ${command} failed: ${result.error.message} | exception | error | build, ci, nodejs, environment |
| ${command} failed with exit code ${result.status ?? "unknown | exception | error | build, ci, nodejs, release |
| Assets directory must be empty to avoid stale tarballs: ${as | exception | error | build, release, ci, hygiene |
| Expected npm pack to produce ${tarballPath} | exception | error | npm, release, build, pack |
| output directory must be empty to avoid stale artifacts: {pa | exception | error | python, release, filesystem, smoke-test |
| expected exactly one {pattern} in {out_dir}, found {len(matc | exception | error | python, maturin, wheel, build |
| {wheel.name} does not contain headroom/_core native extensio | exception | error | python, pyo3, maturin, rust, wheel |
| {wheel.name} should contain exactly one dist-info/METADATA, | exception | error | python, wheel, packaging, metadata |
| {wheel.name} metadata missing {expected_line!r} | exception | error | python, wheel, version, release |
| expected one sdist root directory, found {sorted(roots)} | exception | error | python, sdist, packaging, maturin |
| could not read {pkg_info_path} from {sdist.name} | exception | error | python, sdist, tarfile, packaging |
| {sdist.name} declares no License-File entries | exception | error | python, licensing, sdist, maturin, metadata |
| {sdist.name} declares License-File entries missing from tarb | exception | error | python, licensing, sdist, packaging |
| request was refused by safety classifiers | exception | error | anthropic, llm, api, safety, eval |
| merged.pt missing '{key}'. Found: {sorted(ckpt)}. This scrip | exception | error | pytorch, checkpoint, huggingface, onnx, export |
| {label}: state_dict mismatch (missing={list(missing)[:5]}, u | exception | error | pytorch, state-dict, model-loading, onnx |
| output directory must be empty to avoid stale artifacts: {pa | exception | error | release, smoke-test, filesystem, cli |
| nothing to run: --skip-npm and --skip-python were both set | exception | warning | cli, usage, release, smoke-test |
| expected one Ruff dev dependency, found {ruff_requirements!r | exception | error | ruff, pyproject, dependencies, linting |
| pyproject.toml must contain one exact Ruff pin in project.op | exception | error | ruff, pyproject, version-pinning, linting |
| expected one locked Ruff package, found {versions!r} | exception | error | uv, lockfile, ruff, dependencies |
| could not find a rev for {RUFF_PRE_COMMIT_REPO} | exception | error | pre-commit, ruff, config, yaml |
| tar failed for ${tarballPath}: ${result.stderr || result.std | exception | error | npm, tar, verification, release, spawn |
| ${pkg.name} has non-portable ${field}.${name} spec: ${spec} | exception | error | |
| headroom-openclaw default export must expose register(api) | exception | error | |
| headroom-openclaw must export registerHeadroomPlugin(api) | exception | error | |
| headroom-openclaw default.register must match registerHeadro | exception | error | |
| headroom-openclaw import smoke failed: ${result.error?.messa | exception | error | |
| ${expected.tarball} package name mismatch: expected ${expect | exception | error | |
| ${expected.tarball} version mismatch: expected ${version}, g | exception | error | |
| ${pkg.name} dependency ${name} mismatch: expected ${spec}, g | exception | error | |
| withHeadroom() requires the "ai" package. Install it with: n | exception | error | |
| Failed after ${maxAttempts} attempts: ${lastError} | exception | error | |
| Failed to connect to Headroom at ${this.baseUrl}: ${error} | exception | error | |
| invalid plugin name: ${JSON.stringify(name)} | validation | error |