compaction

type Artifact struct {
	ID                string
	BotID             string
	SessionID         string
	Status            string
	Summary           string
	Version           int
	Coverage          []CoveredSource
	AnchorStartMs     int64
	AnchorEndMs       int64
	Level             int
	ParentIDs         []string
	SupersededBy      string
	SupersededAt      time.Time
	StartedAt         time.Time
	CoverageMalformed bool
}

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

type ArtifactFrontier struct {
	Artifacts []Artifact
	Issues    []LineageIssue
	// contains filtered or unexported fields
}

type ArtifactOwner struct {
	BotID          string
	SessionID      string
	SessionIDKnown bool
}

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

type CompactPolicy string

type CompactionCandidate struct {
	ID           pgtype.UUID
	RawContent   []byte
	RawUsage     []byte
	Record       historyfrag.HistoryRecord
	Policies     []CompactPolicy
	IsToolResult bool
}

type CoveredSource struct {
	Ref                    contextfrag.ContextRef `json:"ref"`
	ExternalMessageID      string                 `json:"external_message_id,omitempty"`
	SourceReplyToMessageID string                 `json:"source_reply_to_message_id,omitempty"`
	CreatedAtMs            int64                  `json:"created_at_ms,omitempty"`
}

type LineageError struct {
	Issue LineageIssue
}

type LineageIssue struct {
	Kind       LineageIssueKind
	ArtifactID string
	RelatedID  string
}

type LineageIssueKind string

type ListLogsResponse struct {
	Items      []Log `json:"items"`
	TotalCount int64 `json:"total_count"`

} // @name compaction.ListLogsResponse

type Log struct {
	ID           string     `json:"id"`
	BotID        string     `json:"bot_id"`
	SessionID    string     `json:"session_id,omitempty"`
	Status       string     `json:"status"`
	Summary      string     `json:"summary"`
	MessageCount int        `json:"message_count"`
	ErrorMessage string     `json:"error_message"`
	Usage        any        `json:"usage,omitempty"`
	ModelID      string     `json:"model_id,omitempty"`
	StartedAt    time.Time  `json:"started_at"`
	CompletedAt  *time.Time `json:"completed_at,omitempty"`

} // @name compaction.Log

type Result struct {
	Status       string
	Summary      string
	MessageCount int
}

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

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

type TriggerConfig struct {
	BotID                 string
	SessionID             string
	ModelID               string // runtime model slug sent to the provider
	ModelRecordID         string // models.id row UUID recorded as artifact/log provenance
	ClientType            string
	APIKey                string //nolint:gosec // runtime credential, not a hardcoded secret
	CodexAccountID        string
	BaseURL               string
	ChatCompletionsCompat string
	HTTPClient            *http.Client
	Ratio                 int
	TotalInputTokens      int
	MaxCompactTokens      int // if > 0, cap compaction input to this many tokens (e.g. 85% of the summarizer window)
	TargetTokens          int // if > 0, compaction goal: reduce context to this many tokens (used by sync compaction)
	// SummaryWindowTokens is the summarizer model's full context window when
	// declared; it bounds the summary output reserve. Zero means unknown and
	// keeps the engine's conservative defaults.
	SummaryWindowTokens int
	// ContextWindowTokens is the chat model's context window. It is separate
	// from SummaryWindowTokens, which belongs to the summarizer model.
	ContextWindowTokens int
	PromptCacheTTL      string
	AllowFrontierFusion bool

	// Manual marks a user-initiated compaction (slash command, HTTP endpoint).
	// Such a request bypasses the per-session failure cooldown so a user who
	// just fixed their credentials/model isn't told "done" while nothing runs.
	// Automatic per-request paths leave this false to keep the cooldown backstop.
	Manual bool

	// HardPressure marks an automatic trigger fired at or above the blocking
	// share of the context window. Such retries re-attempt on an exponential
	// backoff instead of waiting out the full failure cooldown, because every
	// turn until a summary lands degrades or fails.
	HardPressure bool
}

type TriggerModel struct {
	Slug                  string // runtime model slug sent to the provider
	RecordID              string // models.id row UUID recorded as artifact/log provenance
	ClientType            string
	APIKey                string //nolint:gosec // runtime credential, not a hardcoded secret
	CodexAccountID        string
	BaseURL               string
	ChatCompletionsCompat string
	PromptCacheTTL        string
	WindowTokens          int // summarizer model's declared context window
}