agent

type Answer struct {
	Answer     string          `json:"answer"`
	Sources    []Source        `json:"sources"`
	Confidence Confidence      `json:"confidence"`
	Retrieval  RetrievalStatus `json:"retrieval"`
	Usage      CompletionUsage `json:"-"`
}

type AuditEvent struct {
	Phase         AuditPhase    `json:"phase"`
	CorrelationID string        `json:"correlation_id"`
	ActorID       string        `json:"actor_id"`
	TenantID      string        `json:"tenant_id"`
	WorkspaceID   string        `json:"workspace_id"`
	Project       string        `json:"project"`
	Transport     Transport     `json:"transport"`
	ResultClass   string        `json:"result_class"`
	Duration      time.Duration `json:"duration_ns"`
	InputTokens   int           `json:"input_tokens"`
	OutputTokens  int           `json:"output_tokens"`
	SourceCount   int           `json:"source_count"`
	Confidence    string        `json:"confidence,omitempty"`
	Degraded      []string      `json:"degraded,omitempty"`
}

type AuditFailure struct {
	CorrelationID string        `json:"correlation_id"`
	Project       string        `json:"project"`
	ResultClass   string        `json:"result_class"`
	SourceCount   int           `json:"source_count"`
	Duration      time.Duration `json:"duration_ns"`
	ErrorClass    string        `json:"error_class"`
}

type AuditPhase string

type AuditSink interface {
	Record(context.Context, AuditEvent) error
}

type AuditTelemetry interface {
	AuditDeliveryFailed(AuditFailure)
}

type Auditor struct {
	Sink      AuditSink
	Telemetry AuditTelemetry
}

type CompletionClaim struct {
	Text            string   `json:"text"`
	CitationHandles []string `json:"citation_handles"`
}

type CompletionProvider interface {
	Complete(context.Context, CompletionRequest) (CompletionResult, error)
}

type CompletionRequest struct {
	SystemPrompt string
	UserPrompt   string
}

type CompletionResult struct {
	Claims       []CompletionClaim
	InputTokens  int
	OutputTokens int
}

type CompletionUsage struct {
	InputTokens  int
	OutputTokens int
}

type Confidence struct {
	Level string  `json:"level"`
	Score float64 `json:"score"`
}

type Error struct {
	Code ErrorCode
	Err  error
}

type ErrorCode string

type Evidence struct {
	Kind      EvidenceKind `json:"type"`
	Title     string       `json:"title"`
	Path      string       `json:"path,omitempty"`
	LineStart int          `json:"line_start,omitempty"`
	LineEnd   int          `json:"line_end,omitempty"`
	Content   string       `json:"-"`
	Score     float64      `json:"-"`
}

type EvidenceKind string

type LimitPolicy struct {
	Tiers map[string]Limits
}

type LimitTier string

type Limits struct {
	RequestsPerMinute   int
	TokensPerMinute     int
	MaxTenantConcurrent int
	DefaultOutputTokens int
	MaxOutputTokens     int
	JSONTimeout         time.Duration
	StreamTimeout       time.Duration
}

type Message struct {
	Role    string `json:"role"`
	Content string `json:"content"`
}

type QuotaError struct {
	RetryAfter time.Duration
}

type Request struct {
	Scope    Scope     `json:"-"`
	Question string    `json:"question"`
	History  []Message `json:"history,omitempty"`
}

type RetrievalResult struct {
	Evidence []Evidence
	Trace    RetrievalTrace
}

type RetrievalStage struct {
	Name   string
	Status string
	Count  int
}

type RetrievalStageStatus struct {
	Name   string `json:"name"`
	Status string `json:"status"`
	Count  int    `json:"count"`
}

type RetrievalStatus struct {
	Tier             string                 `json:"tier,omitempty"`
	Stages           []RetrievalStageStatus `json:"stages,omitempty"`
	RefinementCount  int                    `json:"refinement_count,omitempty"`
	Generation       string                 `json:"generation,omitempty"`
	Degraded         []string               `json:"degraded"`
	InvalidCitations int                    `json:"invalid_citations,omitempty"`
}

type RetrievalTier string

type RetrievalTrace struct {
	Tier     RetrievalTier
	Stages   []RetrievalStage
	Degraded []string
}

type Retriever interface {
	Retrieve(context.Context, Scope, string, int) ([]Evidence, error)
}

type Scope struct {
	TenantID    string `json:"-"`
	WorkspaceID string `json:"-"`
	Project     string `json:"project"`
}

type ScopedRetriever interface {
	RetrieveScoped(context.Context, Scope, string, int) (RetrievalResult, error)
}

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

type Source struct {
	Handle    string       `json:"handle"`
	Type      EvidenceKind `json:"type"`
	Title     string       `json:"title"`
	Path      string       `json:"path,omitempty"`
	LineStart int          `json:"line_start,omitempty"`
	LineEnd   int          `json:"line_end,omitempty"`
}

type StreamCallbacks struct {
	Meta    func(RetrievalStatus) error
	Delta   func(string) error
	Sources func([]Source) error
}

type StreamingCompletionProvider interface {
	Stream(context.Context, CompletionRequest, func(CompletionClaim) error) (CompletionUsage, error)
}

type Transport string