intent

type Cache interface {
	Get(key string) (string, bool)
	Put(key, summary, agentName, sessionID string)
}

type DisambiguationChoice struct {
	AgentName string
	SessionID string
}

type Disambiguator interface {
	Disambiguate(ctx context.Context, diffFiles []string, candidates []*Match) (DisambiguationChoice, error)
}

type DiscoverOpts struct {
	// HomeDir overrides the user's home directory. Empty means use os.UserHomeDir.
	HomeDir string
	// OriginCWD is the user's actual repo directory (NOT the worktree the
	// pipeline runs in). Symlinks should already be resolved by the caller.
	OriginCWD string
	// WindowStart is the earliest LastActivity allowed (inclusive).
	WindowStart time.Time
	// WindowEnd is the latest StartedAt allowed (inclusive).
	WindowEnd time.Time
}

type ExtractParams struct {
	// HomeDir overrides the user's home directory. Empty means use os.UserHomeDir.
	HomeDir string
	// OriginCWD is the user's actual repo directory. The caller is responsible
	// for passing the original working path, NOT the no-slop worktree.
	OriginCWD string
	// DiffFiles is the repo-relative file set used for matching and scoring.
	DiffFiles []string
	// BaseTime is the committer time of the base SHA.
	BaseTime time.Time
	// HeadTime is the committer time of the head SHA.
	HeadTime time.Time
	// SlackDays extends WindowStart backwards. The plan called for 3 days.
	SlackDays int
	// Threshold is the minimum raw file-overlap score required before applying
	// stricter multi-file and stale-partial acceptance rules.
	Threshold float64
	// Readers are the per-agent transcript readers to consult. Order is
	// insignificant; matching accepts plausible candidates, prefers a single
	// decisive raw-score match, and otherwise ranks by confidence or an optional
	// Disambiguator.
	Readers []Reader
	// Cache is consulted before summarization. Pass NewMemCache() if no DB.
	Cache Cache
	// Summarizer turns the chosen session's text into a short summary.
	Summarizer Summarizer
	// Disambiguator optionally chooses among multiple plausible sessions when
	// file-overlap scoring is not decisive enough to pick one safely.
	Disambiguator Disambiguator
	// Logf receives best-effort accepted candidate diagnostics. Nil disables logging.
	Logf func(format string, args ...any)
}

type Match struct {
	Session *Session
	Score   float64
	// Confidence is the score used to rank accepted candidates after applying
	// recency. Score remains the raw file-overlap score surfaced to callers.
	Confidence float64
	// Overlap lists diff files that appeared in this session. Used purely
	// for diagnostics/telemetry.
	Overlap []string
}

type Message struct {
	Role      Role
	Text      string
	FilePaths []string
	Timestamp time.Time
	// Synthetic marks a message that was inserted by no-slop itself
	// (e.g. a "middle messages omitted" notice from clampMessages). The
	// transcript serializer renders these without a role prefix so the
	// downstream LLM does not mistake them for user or assistant turns.
	Synthetic bool
}

type Reader interface {
	Name() string
	// Discover returns candidate sessions matching opts. Implementations must
	// only read enough of each transcript to populate metadata; full message
	// bodies must wait until Load is called.
	Discover(ctx context.Context, opts DiscoverOpts) ([]*Session, error)
	// Load populates s.Messages with user/assistant text only. Tool calls and
	// tool results must be omitted from Message.Text but file paths they
	// reference may be added to Message.FilePaths.
	Load(ctx context.Context, s *Session) error
}

type Result struct {
	Summary   string
	AgentName string
	SessionID string
	Score     float64
}

type Role string

type Session struct {
	AgentName    string
	SessionID    string
	CWD          string
	StartedAt    time.Time
	LastActivity time.Time
	// LastMsgKey is a per-reader stable identifier for the last message
	// (uuid where available, otherwise a timestamp). Used as the cache key
	// input so repeat extractions on an unchanged session hit the cache.
	LastMsgKey string
	// Messages holds the user/assistant turns. Populated by Reader.Load,
	// not by Discover, since most candidates will be filtered out.
	Messages []Message
	// contains filtered or unexported fields
}

type Summarizer interface {
	Summarize(ctx context.Context, s *Session) (string, error)
}