Skip to main content

Services

ARP Standard v1 defines a set of HTTP services. This section summarizes what each service does and links to the normative OpenAPI + JSON Schema sources.

Standard vs. implementation

This is the spec. For the JARVIS implementation details (how to run these services, CLI flags, defaults), see JARVIS Implementation.

Required endpoints (all services)​

Each service MUST implement:

  • GET /v1/health
  • GET /v1/version

Service map (v1)​

ServicePurposeOpenAPI
Run GatewayClient entrypoint for runsrun-gateway.openapi.yaml
Run CoordinatorRun authority + enforcement pointsrun-coordinator.openapi.yaml
Atomic ExecutorExecute atomic NodeRunsatomic-executor.openapi.yaml
Composite ExecutorExecute composite NodeRunscomposite-executor.openapi.yaml
Node RegistryCatalog NodeTypesnode-registry.openapi.yaml
SelectionGenerate bounded candidate setsselection.openapi.yaml
PDPPolicy decisions (optional)pdp.openapi.yaml

Required endpoints per service are defined by:

  • OpenAPI documents under ARP_Standard/spec/v1/openapi/
  • The conformance required endpoints list: ARP_Standard/spec/v1/conformance/rules/required.md

Run Gateway​

Purpose: client entrypoint for starting/querying/canceling runs (+ optional NDJSON streaming).

Required endpoints:

  • POST /v1/runs
  • GET /v1/runs/{run_id}
  • POST /v1/runs/{run_id}:cancel

Optional endpoint:

  • GET /v1/runs/{run_id}/events (NDJSON)

OpenAPI: ARP_Standard/spec/v1/openapi/run-gateway.openapi.yaml

Details: Run Gateway

Run Coordinator​

Purpose: the run authority. Owns Run + NodeRun lifecycle, enforcement checkpoints, scheduling/dispatch, and durable history.

Required endpoints:

  • POST /v1/runs
  • GET /v1/runs/{run_id}
  • POST /v1/runs/{run_id}:cancel
  • POST /v1/node-runs (create subtasks)
  • GET /v1/node-runs/{node_run_id}
  • POST /v1/node-runs/{node_run_id}:evaluation
  • POST /v1/node-runs/{node_run_id}:complete

Optional endpoints (not required for conformance):

  • GET /v1/runs/{run_id}/events (NDJSON)
  • GET /v1/node-runs/{node_run_id}/events (NDJSON)

OpenAPI: ARP_Standard/spec/v1/openapi/run-coordinator.openapi.yaml

Details: Run Coordinator

Executors, registry, selection, PDP​

These services are referenced throughout the execution fabric:

See also​