---
name: ager-to-langgraph
description: Translate a validated AGER/OKF AgentGraph into a LangGraph StateGraph (Send fan-out, LoopPolicy breaks, ScratchPad state).
---

# AGER → LangGraph

This plugin **compiles**. It does not author AGER. Authoring is `okf-agent-graph`.

## Mapping

| AGER | LangGraph |
| --- | --- |
| AgentGraph | StateGraph + compile() |
| OrchestratorAgent | supervisor node |
| WorkerAgent | Send() fan-out to worker node |
| Judge / Synthesizer | nodes + conditional edges |
| LoopPolicy | recursion_limit + loop_or_end |
| ScratchPad keys | TypedDict state channels |
| Tool + ToolRule | tool node + documented pre-hooks |

## Steps

1. Locate the AGER bundle (`--bundle`, `sample-ager`, or cwd).
2. If `okf-agent-graph` is installed, run `ager-validate` first. If it fails, stop.
3. Run the deterministic emitter:

```bash
python3 scripts/emit.py --bundle <AGER_ROOT> --out <OUT>
```

4. Report written paths. Expected: pyproject.toml, graph.py, state.py, README.md.
5. Never claim production-ready without tests.

## References

- `references/mapping.md`