Skip to main content

Agents Live State

[MODE:OVERSEER] Tier: overseer. Read-only.

Reads transient runtime state for one Agent conversation. Use it when you need live processing state, streamed text, queued turns, or the current activity id without waiting for persisted monitor events.

Inputs

FieldTypeRequiredNotes
agent_idint or stringyesAgent ID or name
conversation_idstringnoSpecific runtime conversation/thread ID

Output

Runtime live state object, typically including conversationId, isProcessing, streamText, currentActivityId, queuedTurns, and startedAt when the runtime exposes them.

Gotchas

  • For multi-conversation Agents, pass conversation_id; otherwise the runtime may return default conversation state.
  • This is transient state. Persisted history lives in fibe_agents_messages and fibe_agents_activity.
  • Empty streamText does not prove the Agent is idle; check isProcessing and queuedTurns.
  • fibe_agents_send_message — enqueue work.
  • fibe_agents_interrupt — stop a stuck turn.
  • fibe_agents_messages / fibe_agents_activity — persisted history.