NousResearch/hermes-agent · error · PluginLlmTrustError

Plugin {plugin_id!r} cannot route through the built-in auxil

Error message

Plugin {plugin_id!r} cannot route through the built-in auxiliary task {task!r} (set plugins.entries.{plugin_id}.llm.allow_task_override to true to allow).

What it means

Error "Plugin {plugin_id!r} cannot route through the built-in auxiliary task {task!r} (set plugins.entries.{plugin_id}.llm.allow_task_override to true to allow)." thrown in NousResearch/hermes-agent.

Source

Thrown at agent/plugin_llm.py:424

        return None
    task = requested_task.strip()
    if not task or task.lower() == "auto":
        return None

    owned, builtin = _resolve_task_ownership(plugin_id)
    if task in owned:
        return task
    if task in builtin:
        if policy.allow_task_override:
            return task
        logger.warning(
            "plugin_llm task routing denied: plugin %r requested built-in "
            "auxiliary task %r without plugins.entries.%s.llm.allow_task_override",
            plugin_id,
            task,
            plugin_id,
        )
        raise PluginLlmTrustError(
            f"Plugin {plugin_id!r} cannot route through the built-in auxiliary "
            f"task {task!r} (set plugins.entries.{plugin_id}.llm."
            f"allow_task_override to true to allow)."
        )
    logger.warning(
        "plugin_llm task routing denied: plugin %r requested auxiliary task %r "
        "it did not register",
        plugin_id,
        task,
    )
    raise PluginLlmTrustError(
        f"Plugin {plugin_id!r} cannot route through auxiliary task {task!r} — a "
        f"plugin may only pass a task key it registered itself via "
        f"ctx.register_auxiliary_task() (or a built-in key when plugins.entries."
        f"{plugin_id}.llm.allow_task_override is true)."
    )

View on GitHub (pinned to c896c09c42)

Solutions

1. Set plugins.entries.<plugin>.llm.allow_task_override to true to let the plugin use this built-in auxiliary task.
2. Have the plugin register its own task key via ctx.register_auxiliary_task() and use that.

When it happens

Trigger: Thrown at agent/plugin_llm.py:424 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of NousResearch/hermes-agent@c896c09c42 (2026-08-14). Data as JSON: /api/errors/aea9d5da350a8e41. Report an issue: GitHub.