Skip to content

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.

Property Type Description
agent object -
agent.id string -
conversation? string -
status "idle" | "running" | "parked" | "asleep" Whether it waits for a message, answers one, waits on a person, or sleeps until something asks it.
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 -