search

type CheckpointResult struct {
	ID             string   `json:"id"`
	Prompt         string   `json:"prompt"`
	CommitMessage  *string  `json:"commitMessage"`
	CommitSubject  *string  `json:"commitSubject"`
	CommitSHA      *string  `json:"commitSha"`
	Branch         string   `json:"branch"`
	Org            string   `json:"org"`
	Repo           string   `json:"repo"`
	Author         string   `json:"author"`
	AuthorUsername *string  `json:"authorUsername"`
	CreatedAt      string   `json:"createdAt"`
	FilesTouched   []string `json:"filesTouched"`
}

type CommitResult struct {
	ID             string  `json:"id"`
	CommitSHA      string  `json:"commitSha"`
	CommitMessage  string  `json:"commitMessage"`
	CommitSubject  string  `json:"commitSubject"`
	Branch         string  `json:"branch"`
	Org            string  `json:"org"`
	Repo           string  `json:"repo"`
	Author         string  `json:"author"`
	AuthorUsername *string `json:"authorUsername"`
	CreatedAt      string  `json:"createdAt"`
	Additions      int     `json:"additions"`
	Deletions      int     `json:"deletions"`
	FilesChanged   int     `json:"filesChanged"`
	HTMLUrl        *string `json:"htmlUrl"`
}

type Config struct {
	Owner    string
	Repo     string
	Repos    []string
	AllRepos bool // When true, search all accessible repos (no repo scoping)
	Query    string
	Limit    int
	Author   string // Filter by author name
	Date     string // Filter by time period: "week" or "month"
	Branch   string // Filter by branch name
	Page     int    // 1-based page number (0 means omit, API defaults to 1)
}

type HTTPStatusError struct {
	StatusCode int
	Message    string
}

type MalformedResponseError struct {
	Message string
}

type Meta struct {
	MatchType string  `json:"matchType"`
	Score     float64 `json:"score"`
	Tier      *int    `json:"tier,omitempty"`
	Snippet   string  `json:"snippet,omitempty"`
	Summary   string  `json:"summary,omitempty"`
	// RerankScore is query-serve's cross-encoder (Cohere) relevance judgement,
	// present only on results that went through reranking. Where present it is
	// the signal the final ordering was built from and the only score
	// comparable across repos — Score is per-namespace retrieval strength, so
	// sorting by it undoes reranking. The cross-cell merge orders tier 0 and
	// tier 1 by this field, matching the BFF (ENT-1425/ENT-1431).
	RerankScore *float64 `json:"rerankScore,omitempty"`
	BM25Score   *float64 `json:"bm25Score,omitempty"`
	ANNScore    *float64 `json:"annScore,omitempty"`
}

type ParsedInput struct {
	Query  string
	Author string
	Date   string
	Branch string
	Repos  []string
}

type Response struct {
	Results  []Result    `json:"results"`
	Total    int         `json:"total"`
	Page     int         `json:"page"`
	Error    string      `json:"error,omitempty"`
	Timing   *Timing     `json:"timing,omitempty"`
	Reranked *bool       `json:"reranked,omitempty"`
	Counts   *TypeCounts `json:"counts,omitempty"`

	// Completeness metadata, same names and semantics as the BFF's merged
	// response (entire.io api/src/routes/search.ts mergeCellResponses) so web
	// and CLI surface identical signals (ENT-1777). Parsed from each cell and
	// re-synthesized by the CLI's own merge.
	Partial            bool            `json:"partial,omitempty"`
	Truncated          bool            `json:"truncated,omitempty"`
	CoverageIncomplete bool            `json:"coverage_incomplete,omitempty"`
	TruncatedTypes     map[string]bool `json:"truncated_types,omitempty"`
	CountsLowerBound   map[string]bool `json:"counts_lower_bound,omitempty"`

	// Warnings are client-side completeness notes (e.g. a truncated repo
	// index or a failed region in a cross-cell fan-out) surfaced to the user
	// on stderr. Never part of the wire format.
	Warnings []string `json:"-"`
}

type Result struct {
	Type       string            `json:"-"`
	Meta       Meta              `json:"-"`
	Checkpoint *CheckpointResult `json:"-"`
	Commit     *CommitResult     `json:"-"`
	Session    *SessionResult    `json:"-"`
	// contains filtered or unexported fields
}

type SessionResult struct {
	SessionID string `json:"sessionId"`
	// MatchedCheckpointID is the carrier checkpoint the search service anchors a
	// session row to — present on every session row. For a server-folded legacy
	// session (ENT-1595) the sessionId is empty and this IS the row's identity
	// (the checkpoint predates the sessionId attribute), so ResultID and the
	// cross-cell dedupe (DedupID) fall back to it, repo-qualified, and a mirrored
	// repo reports the row once instead of twice. Drill-down is
	// `entire checkpoint explain <id>`, not `entire session info`.
	MatchedCheckpointID string  `json:"matchedCheckpointId,omitempty"`
	DisplayName         string  `json:"displayName"`
	Prompt              *string `json:"prompt"`
	Agent               *string `json:"agent"`
	Model               *string `json:"model"`
	StepCount           int     `json:"stepCount"`
	Org                 string  `json:"org"`
	Repo                string  `json:"repo"`
	Branch              *string `json:"branch"`
	AuthorUsername      *string `json:"authorUsername"`
	CreatedAt           string  `json:"createdAt"`
}

type Timing struct {
	TotalMs            *float64 `json:"total_ms"`
	KeywordMs          *float64 `json:"keyword_ms"`
	EmbeddingMs        *float64 `json:"embedding_ms"`
	VectorMs           *float64 `json:"vector_ms"`
	RerankMs           *float64 `json:"rerank_ms"`
	FanoutMs           *float64 `json:"fanout_ms"`
	SessionHydrationMs *float64 `json:"session_hydration_ms"`
}

type TypeCounts struct {
	Repos       int `json:"repos"`
	Checkpoints int `json:"checkpoints"`
	Commits     int `json:"commits"`
	PRs         int `json:"prs"`
	Sessions    int `json:"sessions"`
}