NousResearch/hermes-agent · error · ValueError
complete_structured requires at least one input block
Error message
complete_structured requires at least one input block
What it means
Error "complete_structured requires at least one input block" thrown in NousResearch/hermes-agent.
Source
Thrown at agent/plugin_llm.py:848
"""Run a bounded host-owned structured completion.
``input`` accepts text and image blocks (see
:class:`PluginLlmTextInput` / :class:`PluginLlmImageInput`). When
``json_mode=True`` or ``json_schema`` is provided, the response
is parsed and (if a schema is given) validated; the parsed value
is returned in :attr:`PluginLlmStructuredResult.parsed`.
Validation requires the optional ``jsonschema`` package. When it
isn't installed, JSON mode still works but schema enforcement is
skipped with a debug log.
``task`` routes through a plugin-registered auxiliary slot (see
:meth:`complete`).
"""
if not instructions or not instructions.strip():
raise ValueError("complete_structured requires non-empty instructions")
if not input:
raise ValueError("complete_structured requires at least one input block")
policy = self._policy_loader(self._plugin_id)
eff_task = _check_task(policy, plugin_id=self._plugin_id, requested_task=task)
eff_provider, eff_model, eff_agent, eff_profile = _check_overrides(
policy,
requested_provider=provider,
requested_model=model,
requested_agent_id=agent_id,
requested_profile=profile,
)
messages = _build_structured_messages(
instructions=instructions,
inputs=list(input),
json_mode=json_mode,
json_schema=json_schema,
schema_name=schema_name,
system_prompt=system_prompt,View on GitHub (pinned to c896c09c42)
Solutions
- Pass at least one input block to complete_structured.
When it happens
Trigger: Thrown at agent/plugin_llm.py:848 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/7bb8a2022904c817.
Report an issue: GitHub.