Product model
Agents
Agents give you:- One stable agent URL
- Multiple agent versions behind that URL
- A consistent entry point for creating sessions
Sessions
Sessions give you:- A durable public handle
- Ongoing state across multiple messages
- A stable place to inspect status and outputs
Messages
Messages give you:- Text, file, and image inputs
- Status tracking for each turn
- Structured outputs when available
- Per-message file change tracking
Files
Files give you:- Uploads that can be referenced by later messages
- A session workspace that can be browsed by path
- A consistent file model across inputs and outputs
Design defaults
- Sessions are durable
- Sessions stay on the agent version they started with
- The session filesystem is the user-facing file surface
- Polling is the supported async model