decision

type AdvisedQuery struct {
	Text     string `json:"text"`
	Purpose  string `json:"purpose"`
	Source   string `json:"source"`
	Priority int    `json:"priority"`
}

type Advisor interface {
	RefinePlan(context.Context, PlanAdviceRequest) (PlanAdvice, error)
	VerifyClaims(context.Context, ClaimVerificationRequest) (ClaimVerification, error)
}

type AdvisorUsage struct {
	PromptTokens     int
	CompletionTokens int
	TotalTokens      int
}

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

type Budget struct {
	MaxQueries      int
	MaxPages        int
	MaxRounds       int
	ResultsPerQuery int
	MaxContextChars int
	MaxDuration     time.Duration
	CacheTTL        time.Duration
	NewsCacheTTL    time.Duration
}

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

type ClaimReview struct {
	ClaimID    string   `json:"claim_id"`
	Verdict    string   `json:"verdict"`
	SourceIDs  []string `json:"source_ids"`
	Confidence float64  `json:"confidence"`
	Reason     string   `json:"reason"`
}

type ClaimVerification struct {
	Reviews []ClaimReview `json:"reviews"`
	Usage   AdvisorUsage  `json:"-"`
}

type ClaimVerificationRequest struct {
	Task      Task
	Report    evidence.Report
	MaxClaims int
}

type DefaultFollowUpPlanner struct{}

type DefaultGapDetector struct{}

type DefaultIntentAnalyzer struct{}

type DefaultKnowledgeSynthesizer struct{}

type DefaultQueryPlanner struct{}

type EvidencePipeline interface {
	Merge(evidence.Request, evidence.Report, searchsystem.RoundResult, int) evidence.Report
}

type FollowUpPlanner interface {
	Next(Task, Plan, []Gap, map[string]bool, int) []searchsystem.Query
}

type Gap struct {
	Code        string
	Description string
	Priority    int
}

type GapDetector interface {
	Detect(Task, Plan, evidence.Report) []Gap
}

type Intent struct {
	Kind            string
	Topic           string
	NeedsFreshness  bool
	NeedsAuthority  bool
	NeedsComparison bool
	PreferredSource []searchsystem.SourceKind
}

type IntentAnalyzer interface {
	Analyze(Task) Intent
}

type KnowledgeSynthesizer interface {
	Synthesize(evidence.Report, []Gap, Usage, string) StructuredResult
}

type Outcome struct {
	Plan         Plan
	Report       evidence.Report
	Result       StructuredResult
	Attempted    []searchsystem.Query
	Observations []searchsystem.Observation
	Failures     []string
	FromCache    bool
}

type Plan struct {
	Intent  Intent
	Queries []searchsystem.Query
}

type PlanAdvice struct {
	Queries []AdvisedQuery `json:"queries"`
	Usage   AdvisorUsage   `json:"-"`
}

type PlanAdviceRequest struct {
	Task     Task
	Intent   Intent
	Baseline Plan
	Budget   Budget
}

type Progress struct {
	Stage         string
	Message       string
	Percent       int
	Round         int
	Queries       int
	QueryTexts    []string
	Sources       int
	ValuablePages []ValuablePage
	Confidence    float64
	Completed     bool
}

type QueryPlanner interface {
	Plan(Task, Intent, Budget) Plan
}

type ResearchCache interface {
	Get(context.Context, string, time.Duration) (evidence.Report, bool)
	Put(context.Context, string, evidence.Report)
}

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

type SearchSystem interface {
	ExecuteRound(context.Context, []searchsystem.Query, []string, int, int, int) (searchsystem.RoundResult, error)
}

type Source struct {
	ID        string
	Title     string
	URL       string
	Provider  string
	Score     float64
	Authority float64
	Relevance float64
}

type StructuredResult struct {
	Status         string
	StopReason     string
	Confidence     float64
	Claims         []Claim
	Sources        []Source
	Gaps           []Gap
	Contradictions []evidence.Contradiction
	Usage          Usage
}

type Task struct {
	Kind           string
	Prompt         string
	Goal           string
	Constraints    []string
	InitialQueries []string
	SeedURLs       []string
	MinSources     int
	MaxSources     int
	Date           string
	Language       string
}

type Usage struct {
	Rounds           int
	Searches         int
	Pages            int
	CacheHits        int
	AdvisorCalls     int
	PromptTokens     int
	CompletionTokens int
	TotalTokens      int
	ElapsedMS        int64
	LimitReached     bool
}

type ValuablePage struct {
	ID            string
	Rank          int
	Title         string
	URL           string
	Domain        string
	Provider      string
	Kind          string
	Snippet       string
	ValueSignals  []string
	Authority     float64
	Relevance     float64
	Freshness     float64
	EvidenceScore float64
	Fetched       bool
	PublishedAt   string
}