Skip to content

Evenfire is an intelligence layer platform for running LLM agents that take real actions, on your infrastructure

TypeScript

docs(mcp-host): note that CLERUM_MODEL_NAME needs CLERUM_MODEL_PROVIDER

Alfredo Lopez6e740308cb8b
diff --git a/mcp-host/README.md b/mcp-host/README.md
index c4af62c23..bea3be76e 100644
--- a/mcp-host/README.md
+++ b/mcp-host/README.md
@@ -28,7 +28,7 @@ MCP Host is a Kubernetes-native service that reads Host CRD configuration and pr
| `HCC_AUTHORITY_MAX_STALENESS_MS` | Maximum time a previously published MCP fleet may survive an unavailable HCC (default 180000 ms; hard-capped at 600000 ms). It must be greater than `CLERUM_CONTEXT_MAPPER_POLL_INTERVAL` in cluster mode; invalid combinations fail startup. Minikube pins 60000 ms for its deterministic staleness E2E. | `HCC_AUTHORITY_MAX_STALENESS_MS=180000` |
| `CLERUM_HOST_CONFIG` | Provides a full Host spec as JSON in dev mode, overriding provider/model context env composition. | `CLERUM_HOST_CONFIG={"host":"dev-host","contextRef":"dev-context","secretRef":"dev-secret","model":{"provider":"openai","name":"gpt-5.4-mini"}}` |
| `CLERUM_MODEL_PROVIDER` | Chooses the model provider in dev mode when `CLERUM_HOST_CONFIG` is not set. | `CLERUM_MODEL_PROVIDER=openai` |
-| `CLERUM_MODEL_NAME` | Overrides the default provider model name in dev mode. | `CLERUM_MODEL_NAME=gpt-5.4-mini` |
+| `CLERUM_MODEL_NAME` | Overrides the default provider model name in dev mode. Used only when `CLERUM_MODEL_PROVIDER` is also set; an auto-detected provider keeps its default model. | `CLERUM_MODEL_NAME=gpt-5.4-mini` |
| `CLERUM_MCP_SERVERS` | Supplies dev MCP server definitions as JSON so you can run without context mapper. Each entry needs `name`, `contextRef`, `transport`, `enabled`, and a `status` object — a server whose `status.ready` is not `true` is parsed but skipped as "not ready". | `CLERUM_MCP_SERVERS=[{"name":"filesystem","contextRef":"dev-context","transport":{"type":"streamableHttp","url":"http://localhost:3101"},"enabled":true,"status":{"deployed":true,"ready":true}}]` |
| `CLERUM_MCP_TOOL_TIMEOUT_MS` | Per-call timeout passed to MCP SDK `Client.callTool(...)` requests. The effective timeout is still bounded by any caller workflow or snippet step budget. | `CLERUM_MCP_TOOL_TIMEOUT_MS=1500000` |
| `CLERUM_MCP_TOOL_MAX_TOTAL_TIMEOUT_MS` | Maximum total MCP SDK tool-call budget used at the SDK request boundary. Operators may tune it up to the existing workflow step ceiling; invalid values fail closed at runtime. | `CLERUM_MCP_TOOL_MAX_TOTAL_TIMEOUT_MS=1500000` |
@@ -98,6 +98,13 @@ Configured via the Host CRD `spec.model.provider` field (or
Providers are defined data-first in `src/llm/registryCore.ts` — OpenAI-compatible
providers are pure data entries (adding one requires a descriptor, not new code).
+On minikube, `make minikube-setup` writes the `chatllm` Host's `spec.model`
+from `.env` through `scripts/minikube/host-model.sh`, whose per-provider
+defaults are the table above. With no key it uses `openai`/`gpt-5.4-mini`; it
+refuses `CLERUM_MODEL_NAME` without `CLERUM_MODEL_PROVIDER` and any pair that is
+not an enabled `llm_allowed_models` row. See
+[LLM providers §4.7](../docs/llm-providers/README.md#47-local-minikube-make-minikube-setup).
+
#### Bailian (Alibaba Cloud Model Studio)
Bailian provides access to multiple models through Alibaba Cloud's Coding Plan,
diff --git a/mcp-host/package-lock.json b/mcp-host/package-lock.json
index 41e2ae311..8e0efdca6 100644
--- a/mcp-host/package-lock.json
+++ b/mcp-host/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "clerum-mcp-host",
- "version": "0.1.433",
+ "version": "0.1.434",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "clerum-mcp-host",
- "version": "0.1.433",
+ "version": "0.1.434",
"license": "SEE LICENSE IN LICENSE",
"dependencies": {
"@anthropic-ai/sdk": "^0.32.0",
diff --git a/mcp-host/package.json b/mcp-host/package.json
index 0bcc8bba6..08828de5c 100644
--- a/mcp-host/package.json
+++ b/mcp-host/package.json
@@ -1,6 +1,6 @@
{
"name": "clerum-mcp-host",
- "version": "0.1.433",
+ "version": "0.1.434",
"description": "MCP Host - reads Host CRD and provides LLM access via OpenAI/Claude",
"main": "dist/main.js",
"engines": {