research

type AdvancedRunner interface {
	Runner
	ExecuteWithOptions(context.Context, Plan, ExecuteOptions) (Evidence, error)
}

type Advisor = decision.Advisor

type AgentConfig struct {
	Protocol    Protocol
	CacheDir    string
	Providers   []string
	GitHubToken string
	Resilience  searchsystem.ResilienceConfig
}

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

type Claim struct {
	Text         string
	SourceIDs    []string
	Verification string
	Confidence   float64
}

type Contradiction struct {
	ClaimIDs []string
	Summary  string
	Severity string
}

type Evidence struct {
	Plan           Plan
	Sources        []Source
	Claims         []Claim
	Contradictions []Contradiction
	Gaps           []ResearchGap
	AttemptedQuery []string
	Failures       []string
	Observations   []Observation
	Metrics        Metrics
	LimitReached   bool
	ContextLimit   int
	StopReason     string
	Confidence     float64
}

type ExecuteOptions struct {
	Advisor              Advisor
	EnableModelPlanning  bool
	EnableSemanticVerify bool
	MaxAdvisorClaims     int
	OnProgress           func(Progress) error
}

type Kind string

type Metrics struct {
	PlannerIterations int
	ToolCalls         int
	SearchCalls       int
	FetchCalls        int
	CacheHits         int
	AdvisorCalls      int
	PromptTokens      int
	CompletionTokens  int
	TotalTokens       int
	ElapsedMS         int64
}

type Observation struct {
	Tool       string
	Status     string
	Summary    string
	ErrorCode  string
	ElapsedMS  int64
	Confidence float64
	CacheHit   bool
	Target     string
}

type Plan struct {
	Kind             Kind
	Queries          []string
	SeedURLs         []string
	MinSources       int
	MaxSources       int
	Date             string
	ResolvedRequest  string
	ResearchGoal     string
	Constraints      []string
	ResponseLanguage string
}

type Progress = decision.Progress

type Protocol struct {
	MaxSearches          int
	MaxFetches           int
	MaxResearchRounds    int
	ResultsPerSearch     int
	MaxPlannerIterations int
	MaxExecutionTime     time.Duration
	SearchCacheTTL       time.Duration
	FetchCacheTTL        time.Duration
	ResearchCacheTTL     time.Duration
	NewsCacheTTL         time.Duration
	MaxContextChars      int
	SearchInterval       time.Duration
	FetchInterval        time.Duration
	PerDomainInterval    time.Duration
	MaxFetchRetries      int
	RetryBackoff         time.Duration
}

type ResearchGap struct {
	Code        string
	Description string
	Priority    int
}

type Runner interface {
	Execute(context.Context, Plan) (Evidence, error)
}

type Source struct {
	ID               string
	Title            string
	URL              string
	Snippet          string
	Content          string
	Provider         string
	TrustScore       float64
	TrustLevel       string
	RelevanceScore   float64
	FreshnessScore   float64
	EvidenceScore    float64
	PublishedAt      time.Time
	VerificationNote string
}

type ValuablePage = decision.ValuablePage