node

Overview ¶

Package node exposes a Fort's local runtime over HTTP so another Fort — the control plane — can dispatch runs to this machine (spec 022). It depends only on core/runtime (the interface); cmd/fort injects the concrete native runtime.

The wire protocol is deliberately small:

POST /api/exec              body: RunSpec JSON
                           -> application/x-ndjson: one RunEvent per line,
                              flushed live, until a terminal exited/error, EOF.
POST /api/exec/{id}/signal  body: raw input  -> HITL stdin injection
POST /api/exec/{id}/cancel                    -> cancel a running remote run

Every route requires "Authorization: Bearer <token>" (constant-time compared): the endpoint runs arbitrary agent CLIs, so it is never left unauthenticated.