Saphan StudioDocs
Reference/Command reference

saphan route

Answer the routing decision for a step; optionally request a model-capable client context

saphan route

Answer the routing decision for a step; optionally request a model-capable client context

saphan route <step> [flags]

Decide a step's tier against a routing policy (§6.1): first matching rule wins, then the policy's explicit default.

The policy comes from --policy (one manifest file) or --library (a library tree per §5.1, routing-policy named "default"; pin discipline applies — see 'lib validate --help').

--request-client asks the routing gate for a model-capable client context. On a step routed deterministic the gate refuses: exit 3, and the refusal is recorded in the cost ledger (cost 0, outcome refused). Slice 1 contains no model calls — a granted context is reported and discarded.

Options

OptionTypeDefaultDescription
--allow-unpinnedboolfalseload --library despite a missing or failed pin; recorded in the cost ledger
--genrestringunsettask genre qualifying a generation step
--librarystringunsetlibrary tree; uses its routing-policy named "default"
--pinstringunsetgit tag the --library checkout must be at (§5.1)
--policystringunsetrouting-policy manifest file
--request-clientboolfalseask the routing gate for a model-capable client context

On this page