Skip to content

Endpoint

endpoint

Surface state of a per-task ACP endpoint as the host's discovery view sees it.

The host CLI (terok acp list) and the future TUI panel both render endpoints by status. This catalog defines the enum without dragging the whole roster module in — useful because the host imports the status earlier in its startup than it imports the roster.

ACPEndpointStatus

Bases: StrEnum

Live state of a per-task ACP endpoint.

The host classifier (Project.acp_endpoints) attaches one of these to every running task; the value drives both the rendered row in acp list and the decision acp connect makes about whether to spawn a daemon.

ACTIVE = 'active' class-attribute instance-attribute

Daemon up, socket bound, ready for client connections.

READY = 'ready' class-attribute instance-attribute

Task running with at least one authenticated agent — a daemon will spawn on first terok acp connect.

UNSUPPORTED = 'unsupported' class-attribute instance-attribute

Task running but no in-image agents are authenticated. Connect would fail; surface honestly so the user knows to authenticate.