OptionalfileBase64-encoded file content — present when the action returned the file inline
OptionalfileMJ: Files record ID — present when the action already saved the file to MJStorage
Original filename (e.g. "report.xlsx")
MIME type (e.g. "application/pdf")
OptionalsizeFile size in bytes
OptionalvisibilityHow the artifact MJ creates for this file is shown. Always (default): a normal artifact, with a
card on the message and the viewer. System Only: the artifact, its version and its download URL
exist, but the chat keeps it out of the message cards (a host opts in with showSystemArtifacts).
An action whose file is a DOWNLOAD — an export the user asked for and will open elsewhere — says
so here, instead of the host having to hide a card that opens an empty viewer.
A lightweight reference to a file produced by an agent action (PDF, Excel, Word, etc.). Collected during execution and processed by AgentRunner into MJ: Artifacts after the run.
Distinct from MediaOutput (images/audio/video embedded in the LLM conversation). FileOutputRef represents document files that are archived as versioned artifacts — they are never injected into the LLM context.
Since
5.22.0