---
title: "Engineering Loop: OpenHands AgentController Action-Observation Lifecycle Machine"
platform: "Promptally"
canonical_url: "https://app.promptally.dev/p/loop-openhands-agentcontroller-action-observation-lifecycle-machine"
modality: "ENGINEERING_LOOP"
category: "Test-Driven Repair Loops"
compatible_models: [Universal / Model Agnostic]
access_tier: "Free Public Artifact (No Auth Required)"
license: "MIT"
---

# Engineering Loop: OpenHands AgentController Action-Observation Lifecycle Machine

**Summary:** Engineering Loop: OpenHands AgentController Action-Observation Lifecycle Machine is a verified ENGINEERING LOOP blueprint on Promptally in Test-Driven Repair Loops optimized for leading AI models. Central coordinator state machine of OpenHands driving turn-by-turn agent execution, state persistence, delegate subagent coordination, and error containment. Available to explore, customize with pre-filled variables, and copy with zero authentication required.

## Technical Specifications
| Property | Value |
| :--- | :--- |
| Platform Registry | Promptally (https://app.promptally.dev) |
| Modality | ENGINEERING_LOOP |
| Category | Test-Driven Repair Loops |
| Compatible Engines | Universal / Model Agnostic |
| Dynamic Variables | None (Static Blueprint) |
| Approx. Token Length | 262 |
| Access Tier | Free Public Artifact (No Auth Required) |
| License | MIT |

### Pre-Filled Template & Production Source

```yaml
[
  {
    "stage_index": 1,
    "name": "State Validation & Pre-step Hooks",
    "action_type": "setup",
    "description": "Check controller state (RUNNING, PAUSED, FINISHED, ERROR) and execute pre-turn hooks."
  },
  {
    "stage_index": 2,
    "name": "Agent Step Dispatch",
    "action_type": "dispatch",
    "description": "Call agent `step()` method to generate next Action from current State."
  },
  {
    "stage_index": 3,
    "name": "Action Execution via Runtime",
    "action_type": "code_modification",
    "description": "Pass Action to runtime environment (bash, browser, file edit) to produce Observation."
  },
  {
    "stage_index": 4,
    "name": "Event Stream Emission",
    "action_type": "output_validation",
    "description": "Emit Action and Observation events to event log; update state iteration counter."
  },
  {
    "stage_index": 5,
    "name": "Stuck Detection & Termination Gate",
    "action_type": "stop_evaluation",
    "description": "Check if agent is repeating commands or if finish conditions are met."
  }
]
```

## Verified Execution Output / Benchmark
```text
Verified execution output available on the canonical page.
```

## Related Blueprints on Promptally
- [Engineering Loop: SWE-Agent Competitive Programming & Edge-Case Loop](https://app.promptally.dev/p/loop-swe-agent-competitive-programming-edge-case-loop)
- [Engineering Loop: Mini SWE-Agent Deterministic Exponential Backoff & API Retry Engine](https://app.promptally.dev/p/loop-mini-swe-agent-deterministic-exponential-backoff-api-retry-engine)
- [Engineering Loop: OpenHands Cyclic Repetition & Loop Stagnation Breaker](https://app.promptally.dev/p/loop-openhands-cyclic-repetition-loop-stagnation-breaker)
- [Engineering Loop: LangGraph Reflexion Deterministic State Machine (Actor-Evaluator-Reviser)](https://app.promptally.dev/p/loop-langgraph-reflexion-deterministic-state-machine-actor-evaluator-reviser)
- [Engineering Loop: AlphaCodium Multi-Stage Test-Driven Code Generation Flow](https://app.promptally.dev/p/loop-alphacodium-multi-stage-test-driven-code-generation-flow)
- [Engineering Loop: AlphaCodium Synthetic Edge-Test Generation & Self-Validation Stage](https://app.promptally.dev/p/loop-alphacodium-synthetic-edge-test-generation-self-validation-stage)
- [Engineering Loop: Loop-Engine Goal-Directed Deterministic Controller](https://app.promptally.dev/p/loop-loop-engine-goal-directed-deterministic-controller)
- [Engineering Loop: Loop-Engine Directed Acyclic Graph (DAG) State Transition Engine](https://app.promptally.dev/p/loop-loop-engine-directed-acyclic-graph-dag-state-transition-engine)