contextcount

type CapabilityField ¶

type CapabilityField string

const (
	CapabilityFieldProvider          CapabilityField = "Provider"
	CapabilityFieldTransport         CapabilityField = "Transport"
	CapabilityFieldSecurityIdentity  CapabilityField = "SecurityIdentity"
	CapabilityFieldRetention         CapabilityField = "Retention"
	CapabilityFieldTokenizerRevision CapabilityField = "TokenizerRev"
	CapabilityFieldQuality           CapabilityField = "Quality"
)

type CapabilityKind ¶

type CapabilityKind string

const (
	CapabilityKindCounter   CapabilityKind = "counter"
	CapabilityKindInference CapabilityKind = "inference"
)

type CapabilityValidationError ¶

type CapabilityValidationError struct {
	Capability CapabilityKind
	Field      CapabilityField
	Reason     CapabilityValidationReason
}

func (e *CapabilityValidationError) Error() string

type CapabilityValidationReason ¶

type CapabilityValidationReason string

const (
	CapabilityValidationReasonUnknown    CapabilityValidationReason = "unknown"
	CapabilityValidationReasonOutOfRange CapabilityValidationReason = "out of range"
	CapabilityValidationReasonEmpty      CapabilityValidationReason = "must not be empty"
	CapabilityValidationReasonMustBeZero CapabilityValidationReason = "must be zero"
)

type ContextCount ¶

type ContextCount struct {
	Model       model.ModelKey
	InputTokens content.TokenCount
	Quality     CountQuality
}

ContextCount is the normalized input-token occupancy of one complete request.

type ContextCountError ¶

type ContextCountError struct {
	Model   model.ModelKey
	Quality CountQuality
	Cause   error
}

func (e *ContextCountError) Error() string

func (e *ContextCountError) Unwrap() error

type ContextCountFunc ¶

type ContextCountFunc func(context.Context, inference.Request) (ContextCount, error)

ContextCountFunc adapts a function to the ContextCounter contract.

type ContextCounter ¶

type ContextCounter interface {
	CountContext(context.Context, inference.Request) (ContextCount, error)
	CounterCapability() CounterCapability
}

ContextCounter counts the complete provider-neutral request and declares its secret-free trust posture without performing I/O.

type ContextCounterFunc ¶

type ContextCounterFunc struct {
	Count      ContextCountFunc
	Capability CounterCapability
}

ContextCounterFunc combines a count function with its fixed trust metadata.

func (c ContextCounterFunc) CountContext(ctx context.Context, req inference.Request) (ContextCount, error)

func (c ContextCounterFunc) CounterCapability() CounterCapability

type CountQuality ¶

type CountQuality uint8

CountQuality describes how a context count was produced.

const (
	CountQualityUnknown CountQuality = iota
	CountQualityExactProvider
	CountQualityExactLocal
	CountQualityHeuristicEstimate
)

type CounterCapability ¶

type CounterCapability struct {
	Provider         ProviderID
	Transport        CounterTransport
	SecurityIdentity SecurityIdentity
	Retention        RetentionPosture
	TokenizerRev     TokenizerRevision
	Quality          CountQuality
}

CounterCapability declares the trust and quality posture of a context counter.

func (c CounterCapability) Validate() error

type CounterCompatibilityError ¶

type CounterCompatibilityError struct {
	Inference InferenceCapability
	Counter   CounterCapability
	Reason    CounterCompatibilityReason
	Cause     error
}

func (e *CounterCompatibilityError) Error() string

func (e *CounterCompatibilityError) Unwrap() error

type CounterCompatibilityReason ¶

type CounterCompatibilityReason string

const (
	CounterCompatibilityInvalidInference   CounterCompatibilityReason = "invalid inference capability"
	CounterCompatibilityInvalidCounter     CounterCompatibilityReason = "invalid counter capability"
	CounterCompatibilityProviderMismatch   CounterCompatibilityReason = "provider mismatch"
	CounterCompatibilityIdentityMismatch   CounterCompatibilityReason = "security identity mismatch"
	CounterCompatibilityTransportDowngrade CounterCompatibilityReason = "transport downgrade"
	CounterCompatibilityRetentionDowngrade CounterCompatibilityReason = "retention downgrade"
)

type CounterTransport ¶

type CounterTransport uint8

CounterTransport describes where request bytes travel for counting.

const (
	CounterTransportUnknown CounterTransport = iota
	CounterTransportLocal
	CounterTransportSameEndpoint
	CounterTransportSeparateEndpoint
)

type Estimator ¶

type Estimator struct{}

Estimator deterministically estimates input occupancy from a dialect's encoded complete request. Its zero value is ready for use.

func NewEstimator() *Estimator

func (e *Estimator) CountContext(ctx context.Context, req inference.Request) (ContextCount, error)

func (e *Estimator) CounterCapability() CounterCapability

type EstimatorStateError ¶

type EstimatorStateError struct {
	Reason EstimatorStateReason
}

EstimatorStateError reports invalid estimator state.

func (e *EstimatorStateError) Error() string

type EstimatorStateReason ¶

type EstimatorStateReason string

EstimatorStateReason identifies why an estimator cannot produce a count.

const (
	EstimatorStateNilReceiver EstimatorStateReason = "nil receiver"
	EstimatorStateNilContext  EstimatorStateReason = "nil context"
)

type InferenceCapability ¶

type InferenceCapability struct {
	Provider         ProviderID
	Transport        InferenceTransport
	SecurityIdentity SecurityIdentity
	Retention        RetentionPosture
}

InferenceCapability declares the inference path's trust posture.

func (c InferenceCapability) Validate() error

type InferenceTransport ¶

type InferenceTransport uint8

InferenceTransport describes the inference request's transport protection.

const (
	InferenceTransportUnknown InferenceTransport = iota
	InferenceTransportLocal
	InferenceTransportTLS
	InferenceTransportAttestedTLS
	InferenceTransportEndToEndEncrypted
)

type ModelIdentityError ¶

type ModelIdentityError struct {
	Model model.ModelKey
	Err   error
}

ModelIdentityError reports an unresolved request model identity.

func (e *ModelIdentityError) Error() string

func (e *ModelIdentityError) Unwrap() error

type ProviderID ¶

type ProviderID string

ProviderID identifies the provider or gateway that owns a transport path.

type RequestEncodingError ¶

type RequestEncodingError struct {
	APIFormat model.APIFormat
	Err       error
}

RequestEncodingError reports a dialect encoder failure and preserves its cause.

func (e *RequestEncodingError) Error() string

func (e *RequestEncodingError) Unwrap() error

type RetentionPosture ¶

type RetentionPosture uint8

RetentionPosture describes provider-declared retention of request input.

const (
	RetentionUnknown RetentionPosture = iota
	RetentionNone
	RetentionEphemeral
	RetentionLogged
)

type SecurityIdentity ¶

type SecurityIdentity [32]byte

SecurityIdentity is a digest of canonical endpoint and security-policy identity.

type TokenizerRevision ¶

type TokenizerRevision string

TokenizerRevision identifies the tokenization algorithm used by a counter.

const EstimatorRevision TokenizerRevision = "bundled-openai-responses-anthropic-gemini-bedrock-request-bytes-div4-v3"

type UnsupportedAPIFormatError ¶

type UnsupportedAPIFormatError struct {
	APIFormat model.APIFormat
}

UnsupportedAPIFormatError reports a request dialect without a bundled encoder.

func (e *UnsupportedAPIFormatError) Error() string