This is the canonical description of how managed /api/v3 chat attachments move from
upload to a model request and remain usable when a chat is reopened. It covers the BFF,
managed chat storage, LangGraph checkpoints, OpenRouter's stateless Responses API, and the
Fyler-FE attachment worker.
The design has four constraints:
- Keep the durable file-to-message relationship and trusted metadata.