Skip to content

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

TypeScript

docs: address review findings on the docs reorganization

Jose Gabriel Ramirez Encinas587c37005f32
diff --git a/README.md b/README.md
index c2b0cc273..f268163d8 100644
--- a/README.md
+++ b/README.md
@@ -145,7 +145,8 @@ four layers constrain what it can do:
- **Least privilege.** Each agent reaches only the connectors its `Context`
grants, through short-lived, scope-narrowed tokens that can't widen
themselves. Connector images are checked against an allowlist (audit mode by
- default), and custom workflow coordinator images must be digest-pinned.
+ default), and custom workflow coordinator images must be digest-pinned (the
+ minikube overlay relaxes this for local test fixtures).
- **Deny-all networking.** Runtime namespaces start with no connectivity, and
access is opened per (agent, connector). A connector's egress is limited to
the hosts and ports it declares, unless an operator approves explicit
diff --git a/docs/deploy/llm-providers.md b/docs/deploy/llm-providers.md
index 1db11052c..977136d4b 100644
--- a/docs/deploy/llm-providers.md
+++ b/docs/deploy/llm-providers.md
@@ -85,7 +85,7 @@ returns key names only). To rotate a key, re-enter it.
1. In Control UI, open **Secrets → LLM**, expand the **Azure OpenAI** group,
and enter `azure-openai-api-key`.
2. On the Host, open **Host → Environment** and set `AZURE_OPENAI_ENDPOINT`
- (required; the driver fails closed without it) and optionally
+ (required, must be `https://`; the driver fails closed otherwise) and optionally
`AZURE_OPENAI_API_VERSION`.
3. Set the Host `spec.model.provider: azure`. The model name is your **Azure
deployment name**, not a catalog id, so allowlist the deployment name.
@@ -102,10 +102,11 @@ the other 22 providers are admissible in recipes — see the
the `clerum-model-secret-mapping` caveat.
> **Dev-mode note.** Single-service dev mode (`CLERUM_DEV_MODE=true`, no
-> Kubernetes) reads credentials from env vars and the provider from
-> `CLERUM_MODEL_PROVIDER`. Bedrock's env vars are the standard
-> `AWS_ACCESS_KEY_ID` / `AWS_SECRET_ACCESS_KEY`, so a shell that already exports
-> AWS credentials can auto-select `bedrock`. See
+> Kubernetes) reads credentials from env vars. If `CLERUM_MODEL_PROVIDER` is
+> unset, mcp-host auto-detects the first provider whose keys are present.
+> Because Bedrock's env vars are the standard `AWS_ACCESS_KEY_ID` /
+> `AWS_SECRET_ACCESS_KEY`, a shell that already exports AWS credentials can
+> auto-select `bedrock`; set `CLERUM_MODEL_PROVIDER` explicitly to avoid that. See
> [Local development](../llm-providers/README.md#46-local-development-no-kubernetes).
## 4. Extra credential slots (for provider fallback, R5)
diff --git a/docs/design/agent-models-credentials-ux.md b/docs/design/agent-models-credentials-ux.md
index 41184d470..6e8f9c63d 100644
--- a/docs/design/agent-models-credentials-ux.md
+++ b/docs/design/agent-models-credentials-ux.md
@@ -237,6 +237,3 @@ Host or LLM Secret operation failed when the API can provide that detail.
- The UI preserves drafts on failures and never places secret values in logs,
analytics, documentation, or error messages.
-> **Notion handoff:** This Markdown file is the source draft for the requested Notion
-> page. No Notion connector is available in this workspace, so no external Notion
-> page was created from this session.
diff --git a/docs/design/ai-recipe-builder-app-architecture.md b/docs/design/ai-recipe-builder-app-architecture.md
index 87e421dab..6786cefad 100644
--- a/docs/design/ai-recipe-builder-app-architecture.md
+++ b/docs/design/ai-recipe-builder-app-architecture.md
@@ -172,9 +172,8 @@ workflow-recipes/samples/ai-recipe-builder/
Supporting documentation:
```text
-docs/features/ai-recipe-builder-minikube-operator-cheatsheet.md
-docs/features/ai-recipe-builder-app-architecture.md
-docs/features/control-ui-workflow-recipes-and-registry-guide.md
+docs/design/ai-recipe-builder-app-architecture.md
+docs/deploy/workflow-recipes-guide.md
```
## WorkflowRecipe Definition
diff --git a/docs/llm-providers/README.md b/docs/llm-providers/README.md
index 35b21c09a..a470923a2 100644
--- a/docs/llm-providers/README.md
+++ b/docs/llm-providers/README.md
@@ -225,7 +225,7 @@ slots are all present and uses that provider's default model;
`CLERUM_MODEL_NAME` applies only when `CLERUM_MODEL_PROVIDER` is also set.
> One gotcha: because Bedrock's slots are the standard AWS variable names, a
-> shell that already exports generic AWS credentials (plus `AWS_REGION`) can
+> shell that already exports generic AWS credentials can
> auto-select `bedrock`. Set `CLERUM_MODEL_PROVIDER` explicitly if that's not
> what you want.