domain

type Amount struct {
	Unit  AmountUnit
	Value int64
}

type AmountSelectionSource struct {
	Amount         Amount
	RequestCount   Amount
	PreflightUsage PreflightUsage
	Exposure       economics.ExposureBasis
	Facts          []metering.Fact
	FinalUsage     Amount
	ForSettlement  bool
}

type AmountUnit string

type AuthorityConfig struct {
	Enabled            bool
	Backing            BackingCapability
	UnknownAttribution UnknownAttribution
	Rules              []Rule
}

type AuthorityLevel string

type AuthorityRequirement string

type AuthorityState string

type AuthorityStatus struct {
	State  AuthorityState
	Reason StatusReason
}

type BackingCapability string

type DecisionOutcome string

type DimensionKey = authorityattribution.DimensionKey

type DimensionMatcher = authorityattribution.DimensionMatcher

type Dimensions = authorityattribution.Dimensions

type DimensionsMatcher = authorityattribution.DimensionsMatcher

type EvaluationContext struct {
	Dimensions     Dimensions
	Amount         Amount
	RequestCount   Amount
	PreflightUsage PreflightUsage
	Authority      AuthorityLevel
	At             time.Time
	// LifecycleScope filters rules for request vs attempt admission (Phase 7.2).
	// Empty disables filtering.
	LifecycleScope metering.LifecycleScope
	Exposure       economics.ExposureBasis
	Facts          []metering.Fact
}

type EvaluationResult struct {
	Matches  []RuleMatch
	Selected RuleMatch
}

type FailureBehavior string

type MatchValue = DimensionMatcher

type MeteringBasis string

type PreflightUsage struct {
	InputTokens      int64
	OutputTokens     int64
	CacheReadTokens  int64
	CacheWriteTokens int64
	ReasoningTokens  int64
	TotalTokens      int64
	// TotalTokensPresent distinguishes an authoritative total (including explicit
	// zero) from an omitted total that may be inferred via the inclusion schema.
	TotalTokensPresent bool
}

type ReleaseKey struct {
	ReservationKey ReservationKey
	Sequence       int
}

type ReleaseResult struct {
	Applied       bool
	ReleasedDelta Amount
}

type ReservationKey struct {
	LogicalRequestID string
	ALegID           string
	BLegID           string
	AttemptID        string
	RuleID           string
	Sequence         int
	// Namespace isolates dual-plane reservations. Empty keeps the pre-Phase-7
	// key string format for legacy compatibility.
	Namespace string
}

type Rule struct {
	ID                   string
	Kind                 RuleKind
	Mode                 RuleMode
	Unit                 AmountUnit
	Limit                Amount
	AuthorityRequirement AuthorityRequirement
	FailureBehavior      FailureBehavior
	Window               WindowSpec
	Match                DimensionsMatcher
	// Dual-plane metadata (Phase 7). Legacy rules must set Basis to
	// BasisLegacyProviderPreferredAttempt; new rules require perspective,
	// lifecycle_scope, basis, and namespace.
	Perspective    metering.EconomicPerspective
	LifecycleScope metering.LifecycleScope
	Basis          MeteringBasis
	Namespace      string
	Version        string
}

type RuleKind string

type RuleMatch struct {
	RuleID   string
	RuleIDs  []string
	Kind     RuleKind
	Mode     RuleMode
	Exceeded bool
	Outcome  DecisionOutcome
}

type RuleMode string

type SettlementKey struct {
	ReservationKey ReservationKey
	Sequence       int
}

type SettlementResult struct {
	Applied       bool
	ConsumedDelta Amount
	ReleasedDelta Amount
	OverageDelta  Amount
}

type StatusReason string

type UnknownAttribution string

type WindowAlgorithm string

type WindowBalance struct {
	Consumed Amount
	Reserved Amount
	Released Amount
	Overage  Amount
	// contains filtered or unexported fields
}

type WindowBounds struct {
	Start time.Time
	End   time.Time
}

type WindowKey struct {
	RuleID       string
	DimensionKey DimensionKey
	Start        time.Time
	End          time.Time
}

type WindowSpec struct {
	Algorithm WindowAlgorithm
	Size      time.Duration
	Anchor    time.Time
}