pruning

type CompressHost interface {
	// CompressItems returns the projected context the model sees.
	CompressItems() []Item
	// ArchiveSpan stores the original span for obs_recall and returns its
	// id, or "" when there is no archive.
	ArchiveSpan(key, text string) string
	// QueueCompress records edits to apply before the next request. It
	// refuses a span that overlaps one already queued.
	QueueCompress(edits []Edit) error
}

type CompressPlan struct {
	Edits     []Edit
	Saved     int
	ArchiveID string
}

type CompressTool struct {
	Host CompressHost
}

type Config struct {
	Enabled        bool
	Dedupe         bool
	PurgeErrors    bool
	SupersedeReads bool
	Compress       bool
	// CompressThreshold is the fraction of the context window in use before
	// the compress tool is offered.
	CompressThreshold float64
}

type Edit struct {
	// Index is the item the edit changes.
	Index    int
	TargetID string
	// Replacement is the new content (a JSON string or content array), or
	// nil to omit the entry from context.
	Replacement json.RawMessage
	Strategy    string
	// Saved is the estimated number of context tokens the edit removes.
	Saved int
}

type Item struct {
	// EntryID is the session entry a context edit can target, or "" for
	// messages no edit can change (system messages, summaries, shell runs).
	EntryID string
	// Ordinal is the marker number the compress tool addresses, or 0.
	Ordinal int
	Message agent.AgentMessage
	Tokens  int
	// Edited reports that an earlier context edit already changed the entry.
	Edited bool
}

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

type Policy struct {
	// Cold means the provider's prefix cache is already lost (idle past the
	// TTL, just compacted, first request of a process), so every edit is free.
	Cold bool
	// Force applies every edit regardless of cost, as before a compaction
	// the edits might avoid.
	Force bool
	// Horizon is the expected number of further requests that re-send the
	// context.
	Horizon int
	// WriteReadRatio is the cost of a cache write in cache reads.
	WriteReadRatio float64
}