Skip to content

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

TypeScript

docs(workflow): state that a non-empty allowedTools.include is the complete step toolset

Jose Ramireza63376515171
diff --git a/docs/agents/CLERUM_WORKFLOW_RECIPE_GUIDE.md b/docs/agents/CLERUM_WORKFLOW_RECIPE_GUIDE.md
index b387da6bd..f2eb5a4e6 100644
--- a/docs/agents/CLERUM_WORKFLOW_RECIPE_GUIDE.md
+++ b/docs/agents/CLERUM_WORKFLOW_RECIPE_GUIDE.md
@@ -490,6 +490,14 @@ steps:
include: [search__web_search] # server__tool with double underscore
```
+`allowedTools.include` is the step's **complete** toolset when it is non-empty.
+Only the listed tools are offered to the model and callable, and that includes
+platform tools such as `clerum__generate_pdf`, `clerum__list_workflows` or
+`clerum__get_capabilities`, which must be listed by name. A call to any other
+tool returns an error to the model and does not run. When `include` is omitted
+or empty, a step with `mcpServers` gets every tool of those servers plus the
+`clerum__*` tools, and a step without `mcpServers` is text-only.
+
---
## 6. Sandbox UI (`spec.ui`)
@@ -1283,8 +1291,8 @@ workloads:
instruction: '...' # OR `run: {...}`
dependsOn: [other-step] # Ordering only
mcpServers: [search] # workload IDs of MCP servers callable
- allowedTools: # OBJECT — `include` array of server__tool names
- include: [search__web_search]
+ allowedTools: # OBJECT — `include` array of server__tool names.
+ include: [search__web_search] # Non-empty = the step's ONLY callable tools (list clerum__* too)
maxIterations: 10
timeoutSeconds: 300
backoffSeconds: 5