OptionaldataBase64 encoded data (only if NOT from prompt run)
OptionaldescriptionAgent notes describing what this media represents. Used for internal tracking, debugging, and can be persisted for audit purposes.
OptionaldurationDuration in seconds (for audio/video)
OptionalheightHeight in pixels (for images/video)
OptionallabelAgent-provided label for UI display
OptionalmetadataProvider-specific metadata
MIME type of the media (e.g., 'image/png', 'audio/mp3')
The modality type
OptionalpromptReference to source AIPromptRunMedia (if promoted from prompt execution)
OptionalrefPlaceholder reference ID for the ${media:xxx} pattern. Used to look up media when resolving placeholders in agent output.
OptionalurlURL if available (some providers return URLs)
OptionalwidthWidth in pixels (for images/video)
Represents a media output that an agent has explicitly promoted to its outputs. This is the interface used in ExecuteAgentResult.mediaOutputs.
Media can come from two sources:
Since
3.1.0