AgentSnapshot

What agent.read answers: what the agent or conversation is doing now, and where its log stands. Read and follow the log after cursor.

Properties

Property	Type	Description
agent	object	-
agent.id	string	-
conversation?	string	-
description?	string	What the agent is for, from its definition.
model?	string	The model it runs on, from its definition or the deployment's default.
status	"idle" | "running" | "parked" | "asleep" | "unreadable"	Whether it waits for a message, answers one, waits on a person, sleeps until something asks it, or can't start because its saved state can't be read.
problem?	string	Why its saved state can't be read while status is unreadable, such as a module it names that this release doesn't have. agent.define starts it over.
node?	string | null	The node it runs on, by its name; null while it sleeps.
pending	number	-
activity	Activity	-
interrupts	Interrupt[]	The calls it waits on a person for.
cursor	string	Where its log stands, as events.list and agent.events take it.
next_run?	string | null	When the next of its triggers on a clock runs; null where none does.
spent_today?	Spent	-
reset?	string[]	What agent.define started over because its saved state couldn't be read, and why. Only agent.define answers it.