Types & Sources

Supported Types

Type	Purpose	Accepted Sources
`image`	Vision models and screenshots	`url`, `urls`, `path`, `paths`
`pdf`	Documents; extracted to text when possible	`url`, `urls`, `path`, `paths`
`audio`	Audio clips for transcription/analysis	`url`, `urls`, `path`, `paths`
`video`	Short videos for multimodal models	`url`, `urls`, `path`, `paths`
`file`	Generic files; text files become text parts	`path`, `paths`
`url`	Reference to an absolute HTTP(S) URL	`url`

The url type is validated but not converted to an LLM content part in this phase. Use image/audio/video/pdf/file for multimodal prompts.

Exactly one of these fields must be provided for an attachment that supports multiple sources:

If more than one source field is set (e.g., both url and paths), configuration fails fast with a clear error.

Field	Required	Description
`name`	Optional	Friendly label for tooling and logs; supports templating
`mime`	Optional	Hint for content type overrides; validated against allow-lists
`meta`	Optional	Arbitrary map for adapter hints; currently supports `image_detail` (`low` \| `high` \| `auto`)

attachments:
  - type: image
    url: "https://example.com/sample.png"
    name: "hero"
    meta:
      image_detail: high