Files
Work with files
Agents deal in two kinds of file.
- Attachments are files supplied to an agent or workflow - the contract someone uploaded, the CSV a channel message carried.
- Artifacts are files produced by an agent or tool for someone to download - the report it generated, the archive it built.
Both retain provenance and metadata, and both live outside the sandbox workspace.
The sandbox is not storage
A sandbox is temporary execution space: somewhere an agent can write intermediate files while it works. It is not where results belong, and it is not something a user can reliably reach.
The file store is the durable handoff boundary. When an agent finishes something a person should keep, it publishes an artifact - it does not leave the file in a workspace and describe the path.
When this goes wrong, everything works during testing, and files "disappear" in production when a workspace is recycled.