Route Planning

Route planning turns an agent data need into a route decision, candidate list, rejection, abstention, or procurement preview.

Default Flow

  1. Normalize the request into a route intent.
  2. Retrieve source and capability candidates.
  3. Apply hard filters before ranking.
  4. Score remaining candidates with deterministic evidence.
  5. Preserve optional semantic/model scores as diagnostics, not hidden authority.
  6. Return an explainable plan.
  7. Execute only if the selected route is supported and callable.

Example Intent

Hard Filters

Hard filters can include:
  • supported capability id;
  • required chain or network;
  • configured provider credential;
  • source freshness;
  • caller API-key scope;
  • active billing admission and sufficient request allocation;
  • privacy and redaction policy;
  • payment/procurement policy;
  • route availability.

Outcomes

Non-Goals

Route planning must not silently call suppliers, create payment payloads, grant credentials, or hide rejected candidates and policy reasons.