openhands.controller.state.state

State Objects

@dataclass
class State()

Represents the running state of an agent in the OpenHands system, saving data of its operation and memory.

• Multi-agent/delegate state:

  • store the task (conversation between the agent and the user)
  • the subtask (conversation between an agent and the user or another agent)
  • global and local iterations
  • delegate levels for multi-agent interactions
  • almost stuck state

• Running state of an agent:

  • current agent state (e.g., LOADING, RUNNING, PAUSED)
  • traffic control state for rate limiting
  • confirmation mode
  • the last error encountered

• Data for saving and restoring the agent:

  • save to and restore from a session
  • serialize with pickle and base64

• Save / restore data about message history

  • start and end IDs for events in agent's history
  • summaries and delegate summaries

• Metrics:

  • global metrics for the current task
  • local metrics for the current subtask

• Extra data:

  • additional task-specific data

get_current_user_intent

def get_current_user_intent() -> tuple[str | None, list[str] | None]

Returns the latest user message and image(if provided) that appears after a FinishAction, or the first (the task) if nothing was finished yet.