Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.narrative.io/llms.txt

Use this file to discover all available pages before exploring further.

Surface: GET /agents/runs/{id}, error.type = "AgentLoopMalformedToolName"

​
When this error occurs

The workflow router expects every tool call’s name to be of the form {alias}-{tool_name}, where alias matches ^[a-zA-Z][a-zA-Z0-9]{0,7}$. This error means the name didn’t have a - separator at all, or the part before the - failed the alias regex. Almost always a model hallucination — the catalog enforces the wire-format at creation time, so legitimate tools always have a valid name.

​
How to fix

  • Examine the offending tool name in the failed run’s last assistant turn.
  • Tighten the system prompt or use tool_choice to constrain output (see Unknown Tool Alias for the same pattern).