semescalate

type Authority string

type Budget struct {
	Calls       int
	InputBytes  int
	OutputBytes int
	CostMicros  int64
	WallTime    time.Duration
}

type CallReceipt struct {
	Schema              string
	GapID               string
	InputHandles        []string
	SpanDigests         []string
	PromptDigest        string
	ResponseSchema      string
	ModelRevision       string
	CalibrationDigest   string
	Trigger             Trigger
	Attempt             int
	RequestDigest       string
	ResponseDigest      string
	ParsedDigest        string
	QuestionDigest      string                 `json:",omitempty"`
	Decision            *ChoiceDecisionReceipt `json:",omitempty"`
	ObservedInputBytes  int
	ObservedOutputBytes int
	ObservedCalls       int
	Termination         string
	ProviderReturned    bool // the gate observed Invoke return; false after a timeout it could not observe end
	ProviderReported    Observation
	Rejections          []string
}

type Candidate struct {
	Proposal
	Authority Authority
}

type Capabilities struct {
	ModelRevision     string
	CalibrationDigest string
	ResponseSchema    string
	Remote            bool
}

type ChoiceDecisionReceipt struct {
	Schema               string              `json:"schema"`
	QuestionID           string              `json:"questionId"`
	Choice               string              `json:"choice"`
	Probabilities        []ChoiceProbability `json:"probabilities"`
	ConfidencePPM        uint32              `json:"confidencePpm"`
	ConfidenceBasis      string              `json:"confidenceBasis"`
	MinimumConfidencePPM uint32              `json:"minimumConfidencePpm"`
	Abstained            bool                `json:"abstained"`
}

type ChoiceOption struct {
	ID      string `json:"id"`
	Handle  string `json:"handle"`
	Excerpt string `json:"excerpt"`
}

type ChoiceProbability struct {
	ID    string `json:"id"`
	Value uint32 `json:"value"`
}

type ChoiceQuestion struct {
	ID                   string         `json:"id"`
	Instructions         string         `json:"instructions"`
	Options              []ChoiceOption `json:"options"`
	MinimumConfidencePPM uint32         `json:"minimumConfidencePpm"`
}

type Config struct {
	Provider          Provider
	Verifiers         []Verifier
	Budget            Budget
	AllowRemote       bool
	CostMicrosPerCall int64
}

type Gap struct {
	Repository           string
	Revision             string
	TaskProfile          string
	EvidenceHandles      []string
	AccessContext        string
	VerifierProfile      string
	PolicyDigest         string
	Trigger              Trigger
	MechanicallyResolved bool
}

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

type Limits struct {
	MaxOutputBytes int
	WallTime       time.Duration
}

type Observation struct {
	Tokens     int64
	CostMicros int64
	Model      string
}

type Outcome struct {
	Route      RouteReceipt
	Call       *CallReceipt
	Candidates []Candidate
	Frontier   string
}

type Proposal struct {
	Handle  string `json:"handle"`
	Excerpt string `json:"excerpt"`
}

type Provider interface {
	Describe() Capabilities
	Invoke(ctx context.Context, request []byte, limits Limits) ([]byte, Observation, error)
}

type Reason string

type RouteReceipt struct {
	Schema            string
	GapID             string
	TaskProfile       string
	AccessContext     string
	PolicyDigest      string
	VerifierProfile   string
	VerifierVersion   string
	VerifierPower     string
	Decision          string
	Reason            string
	ModelRevision     string
	CalibrationDigest string
	Budget            Budget
}

type Span struct {
	Handle     string
	Body       []byte
	Authorized bool
}

type Trigger string

type Verifier interface {
	Profile() VerifierProfile
	Admit(span Span, proposal Proposal) (admitted bool, rejection string)
}

type VerifierProfile struct {
	ID      string
	Version string
}