intent block
This canonical lookup describes the published intent interaction shape, the present renderer support, its return path, and the trust boundary that applies when it is shown to a person.
| Type | Contract | Agent may send | Platform may produce | Web renderer | Mobile renderer |
|---|---|---|---|---|---|
| intent | Published | Allowed | No documented platform producer. | IntentBlock | IntentBlockView |
intent
AllowedWhat the agent is about to do, stated before it does it.
Return path
None; this is display content.
Trust and visibility
Agent-authored prose in the platform's markdown subset, untrusted input like every other agent-authored block.
Stability
Valid ONLY in a partial reply; a final carrying one is refused 400 intent_requires_partial. Never appears in a persisted message.blocks as a result — visible only while a reply is still streaming, gone the moment the final result replaces it.
| Field | Required | Published constraint |
|---|---|---|
| type | Yes | literal "intent" |
| text | Yes | string · 1–10000 characters |
JSON
{
"type": "intent",
"text": "Checking fare rules before I answer."
}Web preview
Checking fare rules before I answer.