deepresearch

type Budget struct {
	MaxSteps   int `json:"max_steps"`
	MaxSources int `json:"max_sources"`
	MaxSeconds int `json:"max_seconds"`
}

type Calibration struct {
	Coverage           float64             `json:"coverage"`
	Groundedness       float64             `json:"groundedness"`
	Freshness          float64             `json:"freshness"`
	ConflictRisk       string              `json:"conflict_risk"`
	Confidence         float64             `json:"confidence"`
	RecommendedAction  string              `json:"recommended_action"`
	TakeawayCandidates []TakeawayCandidate `json:"takeaway_candidates,omitempty"`
}

type Citation struct {
	EvidenceID string `json:"evidence_id"`
	Title      string `json:"title"`
	URL        string `json:"url"`
}

type CreateJobRequest struct {
	RequestedID    string                 `json:"requested_id,omitempty"`
	UserID         string                 `json:"user_id,omitempty"`
	TenantID       string                 `json:"tenant_id,omitempty"`
	ConversationID string                 `json:"conversation_id,omitempty"`
	ProviderID     string                 `json:"provider_id,omitempty"`
	Query          string                 `json:"query"`
	RetryContext   string                 `json:"retry_context,omitempty"`
	RetryFeedback  map[string]interface{} `json:"retry_feedback,omitempty"`
	Mode           Mode                   `json:"mode,omitempty"`
	RouteMode      RouteMode              `json:"route_mode,omitempty"`
	Lang           string                 `json:"lang,omitempty"`
	Budget         *Budget                `json:"budget,omitempty"`
	StrictEntity   *bool                  `json:"strict_entity,omitempty"`
	TimeWindows    []string               `json:"time_windows,omitempty"`
	ReportStyle    string                 `json:"report_style,omitempty"`
}

type EntityDisambiguation struct {
	Enabled        bool    `json:"enabled"`
	Threshold      float64 `json:"threshold"`
	FilteredCount  int     `json:"filtered_count,omitempty"`
	AmbiguousCount int     `json:"ambiguous_count,omitempty"`
}

type Event struct {
	ID        string      `json:"id,omitempty"`
	Type      string      `json:"type"`
	Timestamp time.Time   `json:"timestamp"`
	Payload   interface{} `json:"payload,omitempty"`
}

type EventPublisher interface {
	Publish(userID string, eventType string, data any)
}

type Evidence struct {
	ID               string     `json:"id"`
	TaskID           string     `json:"task_id"`
	Query            string     `json:"query"`
	Title            string     `json:"title"`
	URL              string     `json:"url"`
	Snippet          string     `json:"snippet,omitempty"`
	Source           string     `json:"source,omitempty"`
	Domain           string     `json:"domain,omitempty"`
	FetchedAt        time.Time  `json:"fetched_at"`
	PublishedAt      *time.Time `json:"published_at,omitempty"`
	Author           string     `json:"author,omitempty"`
	Quote            string     `json:"quote,omitempty"`
	RelevanceScore   float64    `json:"relevance_score"`
	CredibilityScore float64    `json:"credibility_score"`
	NoveltyScore     float64    `json:"novelty_score"`
	EntityScore      float64    `json:"entity_score,omitempty"`
	ClaimKey         string     `json:"claim_key,omitempty"`
	TimeLabel        string     `json:"time_label,omitempty"`
}

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

type HeuristicPlanner struct{}

type Job struct {
	ID                 string                 `json:"id"`
	ConversationID     string                 `json:"conversation_id,omitempty"`
	UserID             string                 `json:"user_id,omitempty"`
	TenantID           string                 `json:"tenant_id,omitempty"`
	ProviderID         string                 `json:"provider_id,omitempty"`
	Query              string                 `json:"query"`
	RetryContext       string                 `json:"retry_context,omitempty"`
	RetryFeedback      map[string]interface{} `json:"retry_feedback,omitempty"`
	Lang               string                 `json:"lang,omitempty"`
	Mode               Mode                   `json:"mode"`
	RequestedRouteMode RouteMode              `json:"requested_route_mode,omitempty"`
	EffectiveRouteMode RouteMode              `json:"effective_route_mode,omitempty"`
	RouteReason        string                 `json:"route_reason,omitempty"`
	StrictEntity       bool                   `json:"strict_entity,omitempty"`
	TimeWindows        []string               `json:"time_windows,omitempty"`
	ReportStyle        string                 `json:"report_style,omitempty"`
	Status             JobStatus              `json:"status"`
	Budget             Budget                 `json:"budget"`
	Progress           int                    `json:"progress"`
	Stage              string                 `json:"stage,omitempty"`
	Iteration          int                    `json:"iteration,omitempty"`
	LatestGap          string                 `json:"latest_gap,omitempty"`
	LatestAction       string                 `json:"latest_action,omitempty"`
	Error              string                 `json:"error,omitempty"`
	CreatedAt          time.Time              `json:"created_at"`
	UpdatedAt          time.Time              `json:"updated_at"`
	CompletedAt        *time.Time             `json:"completed_at,omitempty"`
	Tasks              []Task                 `json:"tasks,omitempty"`
	Evidence           []Evidence             `json:"evidence,omitempty"`
	Report             *Report                `json:"report,omitempty"`
}

type JobStatus string

type JobSummary struct {
	ID             string    `json:"id"`
	JobID          string    `json:"job_id"`
	Query          string    `json:"query"`
	Status         JobStatus `json:"status"`
	Stage          string    `json:"stage,omitempty"`
	Progress       int       `json:"progress"`
	Iteration      int       `json:"iteration,omitempty"`
	LatestAction   string    `json:"latest_action,omitempty"`
	LatestGap      string    `json:"latest_gap,omitempty"`
	ConversationID string    `json:"conversation_id,omitempty"`
	UpdatedAt      time.Time `json:"updated_at"`
}

type Mode string

type Planner interface {
	Plan(query string, mode Mode, lang string) []Task
}

type Report struct {
	Answer               string                   `json:"answer"`
	Confidence           float64                  `json:"confidence"`
	Citations            []Citation               `json:"citations"`
	OpenQuestions        []string                 `json:"open_questions,omitempty"`
	SupportCount         int                      `json:"support_count,omitempty"`
	ConflictCount        int                      `json:"conflict_count,omitempty"`
	HasConflict          bool                     `json:"has_conflict,omitempty"`
	Iterations           int                      `json:"iterations,omitempty"`
	StopReason           string                   `json:"stop_reason,omitempty"`
	CitationCoverage     float64                  `json:"citation_coverage,omitempty"`
	EntityDisambiguation *EntityDisambiguation    `json:"entity_disambiguation,omitempty"`
	StageErrors          []string                 `json:"stage_errors,omitempty"`
	TimelineSections     []TimelineSection        `json:"timeline_sections,omitempty"`
	ResearchTrace        []ResearchTraceEntry     `json:"research_trace,omitempty"`
	VerificationSummary  *VerificationSummary     `json:"verification_summary,omitempty"`
	Calibration          *Calibration             `json:"calibration,omitempty"`
	ItemsBySource        map[string]interface{}   `json:"items_by_source,omitempty"`
	ErrorsBySource       map[string]string        `json:"errors_by_source,omitempty"`
	Clusters             []map[string]interface{} `json:"clusters,omitempty"`
	LookbackDays         int                      `json:"lookback_days,omitempty"`
	BrowserAssisted      bool                     `json:"browser_assisted,omitempty"`
	RetrievalProfile     string                   `json:"retrieval_profile,omitempty"`
}

type ResearchTraceEntry struct {
	Iteration           int    `json:"iteration"`
	Focus               string `json:"focus,omitempty"`
	Gap                 string `json:"gap,omitempty"`
	FollowUpQuery       string `json:"follow_up_query,omitempty"`
	EvidenceAdded       int    `json:"evidence_added,omitempty"`
	VerificationOutcome string `json:"verification_outcome,omitempty"`
}

type RouteMode string

type RoutePolicy struct{}

type SearchHit struct {
	Title       string
	URL         string
	Description string
	Source      string
}

type Searcher interface {
	Search(ctx context.Context, query string, maxResults int, lang string) ([]SearchHit, error)
}

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

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

type SummaryInput struct {
	Query               string
	Lang                string
	Evidence            []Evidence
	AllEvidence         []Evidence
	Draft               string
	ResearchTrace       []ResearchTraceEntry
	VerificationSummary *VerificationSummary
}

type SummarySynthesizer interface {
	Summarize(ctx context.Context, input SummaryInput) (string, error)
}

type TakeawayCandidate struct {
	Lesson      string   `json:"lesson"`
	WhenToApply string   `json:"when_to_apply,omitempty"`
	Evidence    string   `json:"evidence"`
	EvidenceIDs []string `json:"evidence_ids,omitempty"`
	Confidence  float64  `json:"confidence,omitempty"`
	TargetFile  string   `json:"target_file,omitempty"`
}

type Task struct {
	ID          string   `json:"id"`
	Question    string   `json:"question"`
	Priority    int      `json:"priority"`
	Depth       int      `json:"depth"`
	Status      string   `json:"status"`
	Axis        string   `json:"axis,omitempty"`
	Category    string   `json:"category,omitempty"`
	TimeWindow  string   `json:"time_window,omitempty"`
	FollowUpOf  string   `json:"follow_up_of,omitempty"`
	NegKeywords []string `json:"neg_keywords,omitempty"`
}

type TimelineSection struct {
	Label       string   `json:"label"`
	Highlights  []string `json:"highlights,omitempty"`
	EvidenceIDs []string `json:"evidence_ids,omitempty"`
}

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

type VerificationItem struct {
	Focus       string   `json:"focus,omitempty"`
	Gap         string   `json:"gap,omitempty"`
	Status      string   `json:"status,omitempty"`
	Summary     string   `json:"summary,omitempty"`
	EvidenceIDs []string `json:"evidence_ids,omitempty"`
}

type VerificationSummary struct {
	ResolvedCount     int                `json:"resolved_count,omitempty"`
	ConflictedCount   int                `json:"conflicted_count,omitempty"`
	InsufficientCount int                `json:"insufficient_count,omitempty"`
	Items             []VerificationItem `json:"items,omitempty"`
}