> ## Documentation Index
> Fetch the complete documentation index at: https://praison.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Frame Decode Error • AI Agent SDK

> FrameDecodeError: Raised when a raw inbound frame fails schema validation.

# FrameDecodeError

> Defined in the [**protocols**](../modules/protocols) module.

<Badge color="blue">AI Agent</Badge>

Raised when a raw inbound frame fails schema validation.

Carries a structured :class:`HelloError` so the transport can reject the
frame deterministically with the existing `(code, next_step,
retry_after_seconds)` contract instead of a per-handler `try/except` and
ad-hoc `isinstance` checks. The wrapper server maps `error.to_dict()`
onto the outbound `hello_error` (or `error`) frame.

Attributes:
error: The structured rejection envelope to send back to the client.

## Constructor

<ParamField query="error" type="HelloError" required={true}>
  No description available.
</ParamField>

## Source

<Card title="View on GitHub" icon="github" href="https://github.com/MervinPraison/PraisonAI/blob/main/src/praisonai-agents/praisonaiagents/gateway/protocols.py#L382">
  `praisonaiagents/gateway/protocols.py` at line 382
</Card>

***

## Related Documentation

<CardGroup cols={2}>
  <Card title="Code Agent" icon="code" href="/docs/docs/features/codeagent" />

  <Card title="Code Feature" icon="terminal" href="/docs/docs/features/code" />
</CardGroup>