terminaldecision

type ActionFact struct {
	ItemID string
	CallID string
	Kind   lipapi.ItemKind
	Status lipapi.ItemStatus
	Name   string
}

type CandidateCause string

type CanonicalTerminalCandidate struct {
	Cause           CandidateCause
	Reference       string
	OutputCommitted bool
}

type ContinuationEvidence struct {
	TrajectoryRef string
	Attempt       uint8
}

type ContinuationIntent struct {
	TrajectoryRef string
	ControlRef    string
	Instruction   string
	Provenance    string
	ReasonCode    string
}

type Decision struct {
	Kind       DecisionKind
	ReasonCode string
	Continue   *ContinuationIntent
}

type DecisionKind string

type Evidence struct {
	Objective     string
	RecentText    string
	CandidateText string

	Actions     [MaxEvidenceActions]ActionFact
	ActionCount uint8

	// ExplicitCompletion is an observation: the platform saw one trusted
	// explicit-completion signal for this logical response. It is true either
	// for an ordinary client/harness-owned completion tool call with a matching
	// completed result, or for a valid proxy-owned control completion the
	// platform handled privately. Observation alone never asserts that the
	// proxy asked for that signal.
	ExplicitCompletion bool
	// ExplicitCompletionExpected is an expectation: this response actually ran
	// with a successfully active proxy-owned model control protocol, so an
	// explicit completion signal was requested of the model.
	//
	// It is additive and independent of ExplicitCompletion. All four
	// combinations are legal and no platform rule relates the two: an expected
	// signal may be absent, and a client/harness-owned completion may be
	// observed with no proxy expectation at all. The zero value is the correct
	// projection for every provider and generation that never had a proxy-owned
	// control protocol, so a caller that ignores this field observes exactly the
	// pre-existing contract.
	ExplicitCompletionExpected bool
	Lineage                    EvidenceLineage
}

type EvidenceLineage struct {
	TrajectoryRef string
	ParentRef     string
	ProgressRef   string
	Attempt       uint8
}

type Input struct {
	Candidate    CanonicalTerminalCandidate
	Request      RequestIdentity
	Policy       PolicySnapshot
	Continuation ContinuationEvidence
	Evidence     Evidence
	// Auxiliary is the optional request-pinned child client. It has no terminal,
	// backend, steering, or snapshot authority.
	Auxiliary auxiliary.Client
	Deadline  time.Time
}

type PolicySnapshot struct {
	Revision                string
	MaxContinuationAttempts uint8
}

type Provider interface {
	ID() string
	Decide(context.Context, Input) (Decision, error)
}

type RequestIdentity struct {
	RequestID string
	TraceID   string
	ALegID    string
	BLegID    string
}