routing

type Plan struct {
	Model       *model.Model
	Snapshot    *model.Snapshot
	Policy      *policy.Policy
	HostBinding *binding.Binding
	Host        *host.Host
	Provider    string
	Keys        []*hostkey.HostKey

	// Pricing is the rate sheet billing against the chosen binding (explicit
	// binding ref first, else the host-owned (model, host) cover). Resolved
	// here so emit-time cost stamping costs zero extra lookups. Nil = unpriced.
	Pricing *pricing.Pricing

	// PayloadLoggingEnabled is the resolved opt-in for full request/response
	// body capture: true when the matched Policy or the inbound RelayKey
	// sets PayloadLoggingEnabled. Read by the inference entry to flag the
	// lifecycle Context so the payloadlog observer captures bodies.
	PayloadLoggingEnabled bool

	// UpstreamOverride, when non-empty, replaces Snapshot.Upstream() as
	// the wire model name. Set only by declared-alias resolution: the
	// alias string itself (exact match) or the caller's raw request
	// string (wildcard match). Consumers read the wire name via
	// UpstreamModel(), never Snapshot.Upstream() directly.
	UpstreamOverride string

	// ResolvedVia tags non-canonical resolution for usage events, e.g.
	// "alias:claude-fable-5[1m]" (the declared alias or pattern that
	// matched). Empty for normal snapshot-name resolution.
	ResolvedVia string
}

type Request struct {
	// ModelName is the slug or upstream-name reference the caller asked
	// for (typically from the body's "model" field), possibly with a
	// header-derived "@host" pin folded in by the handler.
	ModelName string

	// RawModelName is the verbatim caller string before any header pin
	// folding. Carried upstream as the wire name when the ref matches a
	// wildcard alias. Falls back to ModelName when empty.
	RawModelName string

	// RelayKey is the authenticated key (already validated for auth).
	// Its Spec.PolicyID drives policy selection.
	RelayKey *relaykey.RelayKey

	// SkipKeyCheck, when true, suppresses the Policy.HostKeyIDs → host
	// coverage gate. Used by proxy mode: the caller brings their own
	// upstream credentials, so the relay's keypool is irrelevant — only
	// the (model, binding, host) tuple matters. Plan.Keys is nil in
	// this mode.
	SkipKeyCheck bool
}

type Resolver struct {
	// contains filtered or unexported fields
}