backend

type BackendFacts struct {
	Capabilities []lipapi.Capability
	Dialects     lipapi.DialectSupport
}

type BackendHarness interface {
	Subject() semantic.SubjectDescriptor
	Backend(ctx context.Context) (BackendView, error)
	Upstream() UpstreamProbe
	Reset(ctx context.Context) error
}

type BackendView interface {
	Open(ctx context.Context, call *lipapi.Call) (lipapi.EventStream, error)
	EffectiveCapabilities(ctx context.Context, call *lipapi.Call) BackendFacts
	// Probe executes a positive semantic scenario and reports canonical/upstream evidence.
	Probe(ctx context.Context, scenario semantic.ScenarioDescriptor, probe UpstreamProbe) (semantic.ExecutionEvidence, error)
}

type CapturedRequest struct {
	Method string
	Path   string
	Header map[string][]string
	Body   []byte
}

type ExecBackendView struct {
	Backend    execbackend.Backend
	Candidate  routing.AttemptCandidate
	Invocation lipapi.Invocation
}

type HardNegativeView interface {
	Reject(ctx context.Context, call *lipapi.Call, scenario semantic.ScenarioDescriptor) (semantic.ExecutionEvidence, error)
}

type PromptCacheResidencySubject interface {
	promptcache.Controller
	Issue(targetID promptcache.TargetID, generationID promptcache.GenerationID, renewable bool) (promptcache.Observation, error)
	Observations() []promptcache.Observation
	Evict(handle promptcache.Handle) error
	SetAffinityAvailable(bool)
	Close() error
	UpstreamResident(handle promptcache.Handle) bool
}

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

type UpstreamProbe interface {
	RequestCount() int
	LastRequest() CapturedRequest
	Reset()
}