actx

type ClearToolArguments struct {
	// KeepRecent is the number of recent assistant messages with tool calls
	// kept intact. Defaults to 3.
	KeepRecent int
	// MinBytes skips arguments shorter than this. Defaults to 1024.
	MinBytes int
}

type ClearToolResults struct {
	// KeepRecent is the number of recent tool result messages kept intact.
	// All results of one batch of parallel calls share a message. Defaults
	// to 3.
	KeepRecent int
	// MinBytes skips results shorter than this. Defaults to 256.
	MinBytes int
}

type CompactInput struct {
	System   string
	Messages []*model.Message
	// Target is the desired size of the messages in tokens.
	Target  int
	Counter TokenCounter
}

type CompactOutput struct {
	Messages []*model.Message
	// Summary is set by summarizing strategies.
	Summary string
}

type CompactResult struct {
	Messages []*model.Message
	Before   int
	After    int
	Summary  string
}

type Config struct {
	Window  Window
	Counter TokenCounter
	// Strategy compacts the conversation. Defaults to
	// Chain(ClearToolResults{}, ClearToolArguments{}, Truncate{}).
	Strategy  Strategy
	Providers []Provider
	// DisableAutoCompact turns off automatic compaction; Compact can still be
	// called explicitly.
	DisableAutoCompact bool
}

type EstimateCounter struct{}

type Input struct {
	SessionID string
	Agent     string
	// Messages is the conversation history before the new input.
	Messages []*model.Message
	// Query is the text of the new user input.
	Query string
}

type InstructionConfig struct {
	// Dir is the working directory instructions are loaded for. Defaults to
	// ".".
	Dir string
	// Names lists the instruction file names checked in each directory, in
	// order of precedence; the first one that exists as a file is loaded
	// and the rest are ignored. Names may contain slash-separated
	// subdirectories, such as ".claude/CLAUDE.md", but must stay inside the
	// directory. Defaults to AGENTS.override.md, AGENTS.md, CLAUDE.md.
	Names []string
	// LocalNames lists files loaded in each directory after the file chosen
	// from Names, all that exist, for example CLAUDE.local.md. None by
	// default.
	LocalNames []string
	// RootMarkers are the entries, of any type, that mark the project root.
	// Directories are searched from the nearest ancestor of Dir containing
	// a marker down to Dir. When no ancestor has a marker, or the list is
	// empty but not nil, only Dir is searched. Defaults to .git.
	RootMarkers []string
	// UserFiles are personal instruction files, such as
	// ~/.codex/AGENTS.md, loaded before the project's, in order. Missing
	// files are skipped. A leading ~ is the user's home directory. No file
	// outside the project is read unless listed here or in ImportDirs.
	UserFiles []string
	// ImportDirs are directories outside the project root from which any
	// instruction file may import. A leading ~ is the user's home
	// directory.
	ImportDirs []string
	// MaxBytes bounds the total size of all files loaded; the content past
	// it is dropped with a note. Defaults to DefaultInstructionMaxBytes; a
	// negative value disables the limit.
	MaxBytes int
	// ImportDepth bounds how many hops of @path imports are followed.
	// Defaults to DefaultImportDepth; a negative value disables imports.
	ImportDepth int
	// Priority orders the sections among those of other providers.
	Priority int
}

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

type MiddlewareOption func(*middleware)

type Placement int

type Prepared struct {
	// System is the base instructions followed by system sections.
	System string
	// Reminder is the combined reminder sections, already wrapped in a
	// <system-reminder> block, or empty.
	Reminder string
}

type Provider interface {
	Sections(ctx context.Context, in *Input) ([]Section, error)
}

type ProviderFunc func(ctx context.Context, in *Input) ([]Section, error)

type Section struct {
	Name      string
	Content   string
	Placement Placement
	// Priority orders sections; lower values come first. Sections with equal
	// priority keep provider order.
	Priority int
}

type Strategy interface {
	Compact(ctx context.Context, in *CompactInput) (*CompactOutput, error)
}

type StrategyFunc func(ctx context.Context, in *CompactInput) (*CompactOutput, error)

type Summarize struct {
	Model model.Model
	// KeepRecent defaults to 2.
	KeepRecent int
	// Prompt defaults to DefaultSummaryPrompt.
	Prompt string
	// MaxTokens bounds the summary. Defaults to 4096.
	MaxTokens int
	// MaxResultBytes truncates each tool result in the transcript. Defaults
	// to 2000.
	MaxResultBytes int
}

type TokenCounter interface {
	CountText(s string) int
	CountMessages(msgs []*model.Message) int
}

type Truncate struct {
	// KeepRecent defaults to 1.
	KeepRecent int
}

type Window struct {
	// Limit is the model's context window in tokens.
	Limit int
	// ReserveOutput is kept free for the response.
	ReserveOutput int
	// Threshold is the fraction of the usable window at which automatic
	// compaction starts. Defaults to 0.8.
	Threshold float64
	// TargetRatio is the fraction of the usable window that compaction aims
	// for. Defaults to 0.5.
	TargetRatio float64
}