Files

A file is anything attached to or produced inside a chat. Two things look identical here on purpose — you do not need to tell them apart:

• uploads — files a user attached to the chat.
• artifacts — outputs an agent produced (reports, code, charts, stamped PDFs).

All three file tools speak one vocabulary; each returned file carries a kind (upload or artifact) if you ever need to know.

• read_file(file_id) — full text content of one file by id (upload OR artifact). Images / scanned files return metadata + a note (vision reads aren’t available over MCP).
• list_files(chat_id) — everything in a chat: uploads + artifacts produced there.
• search_files(...) — find files across scopes: by chat_id, by agent, or org-wide, optionally filtered by title_contains / type.

This is the same surface agents use at run time, so what you see here matches what an agent sees.