Skip to main content

Conformance

ARP Standard conformance is defined by a small set of required endpoints and by schema-valid payloads. The ARP_Standard repository includes golden JSON vectors you can use to validate an implementation.

Standard vs. implementation

This page describes how ARP Standard defines conformance. Implementations (including JARVIS) may provide additional optional endpoints and fields (via extensions), but they still need to satisfy the required v1 contracts to be considered conformant.

What “conformant” means (v1)​

At a minimum:

  • Each service implements the required v1 endpoints listed in ARP_Standard/spec/v1/conformance/rules/required.md.
  • Requests and responses validate against the JSON Schemas in ARP_Standard/spec/v1/schemas/**.

Required vs. optional endpoints (v1)​

All services MUST implement:

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

Run Gateway MUST implement:

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

Run Coordinator MUST implement:

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

Atomic Executor MUST implement:

  • POST /v1/atomic-node-runs:execute

Composite Executor MUST implement:

  • POST /v1/composite-node-runs:begin

Node Registry MUST implement:

  • GET /v1/node-types
  • POST /v1/node-types
  • GET /v1/node-types/{node_type_id}

Selection MUST implement:

  • POST /v1/candidate-sets

PDP MUST implement:

  • POST /v1/policy:decide

Optional endpoints are also enumerated in the required endpoints file.

Source of truth

The canonical list lives in ARP_Standard/spec/v1/conformance/rules/required.md.

Golden vectors​

The ARP_Standard/spec/v1/conformance/json_vectors/ directory contains known-good JSON payloads that must validate against their matching JSON Schemas under ARP_Standard/spec/v1/schemas/.

Validate locally​

Run these from the ARP_Standard repository root.

Install validator deps:

python3 -m pip install -r tools/validate/requirements.txt

Run validation:

python3 tools/validate/validate_json_vectors.py --include-examples

Success means every JSON file in:

  • spec/v1/conformance/json_vectors/
  • spec/v1/examples/ (when --include-examples is set)

validates against its matching schema in spec/v1/schemas/.

See also​