01
Adapter guide
Build your own adapter
Your adapter is an external program that speaks HTTP.
If you can implement these three pieces, you can participate in the runtime:
02
POST /policy
03
one worker that claims admitted work and posts outcomes
The fastest path to your first adapter
That is enough to prove you can build your own adapter.
01
Pick one narrow target and one narrow operation.
02
Implement POST /state for that target.
03
Implement POST /policy with one admitted path and one blocked path.
04
Start a worker that claims only for your target_adapter.
05
Submit one intent and watch the full flow complete.
Three example shapes
The first useful adapter does not need to cover the whole system.
Repository adapter
open or update one pull request
Ticket adapter
move one ticket or add one note
ImpactRoom-style reference adapter
materialize one room-side effect after claim
What you do not need
- import Core packages
- import Adapter Host packages
- reimplement decision validation
- invent WorkOrders
- invent leases
- build a browser-facing ingress API
Useful public adapters
Reference adapters
Available
GitHub Gateway
The first reference adapter: guarded GitHub pull requests and verified same-PR follow-ups for coding agents.
Available
Impact Room
A reference environment adapter for showing bounded agent action against a small inspectable target system.