compact

type Config struct {
	// ContextWindow ≤0 → DefaultContextWindow。
	ContextWindow int
	// MaxOutputTokens ≤0 → DefaultOutputReserve；实际预留 = min(值, ReserveCap)。
	MaxOutputTokens int
	// BufferTokens ≤0 → DefaultBuffer。
	BufferTokens int
	// MaxConsecutiveFailures ≤0 → MaxConsecutiveFailures。
	MaxConsecutiveFailures int
	// Enabled nil = 启用；false = 整体关闭（决策面仍返回计量供观测）。
	Enabled *bool
}

type Decision struct {
	ShouldCompact   bool
	Reason          Reason
	TokenCount      int
	TokenSource     TokenSource
	EstimatedTokens int
	Threshold       int
	ContextWindow   int
	EffectiveWindow int
	OutputReserve   int
}

type ErrRapidRefill struct {
	ConsecutiveRapidRefills int
	ToolTurnsSinceCompact   int
}

type Message struct {
	Role string // RoleUser | RoleAssistant | RoleTool（词表常量见下）
	Text string
	// ToolCalls assistant 发起的工具调用（token 估算必须计入——大型入参若只计
	// 正文，auto-compact 与预算口径都会低估，ZCode 踩过的漏计面）。
	ToolCalls []ToolCall
	// ToolCallID / ToolName role=tool 时标识对应调用与工具名。
	ToolCallID string
	ToolName   string
	// IsError 工具结果失败（microcompact 默认保留——出错结果是排障证据）。
	IsError bool
}

type MicroConfig struct {
	// ThresholdTokens ≤0 = 不按 token 触发（仍可 idle 触发）。
	ThresholdTokens int
	// Idle 空闲触发阈值：0 → DefaultIdle；负值禁用 idle 触发。
	Idle time.Duration
	// KeepRecent 保留最近 N 组工具结果（≤0 → DefaultKeepRecent，下限 1）。
	KeepRecent int
	// CompactableTools 可清除的工具名集合：nil = 不限（全部工具结果可清除）。
	// agentkit 无 ZCode 的内置工具名缺省表，生产装配应传实际名单收紧面。
	CompactableTools []string
	// ClearErrorResults 是否清除出错结果（缺省 false——出错结果是排障证据）。
	ClearErrorResults bool
	// MinTokenSavings ≤0 → DefaultMinTokenSavings。
	MinTokenSavings int
	// Enabled nil = 启用。
	Enabled *bool
}

type MicroReason string

type MicroResult struct {
	Reason          MicroReason
	Trigger         MicroTrigger
	Messages        []Message
	TokensBefore    int
	TokensAfter     int
	TokensSaved     int
	ClearedIDs      []string
	ThresholdTokens int
}

type MicroTrigger string

type RapidRefillDecision struct {
	ConsecutiveRapidRefills int
	ShouldBlock             bool
	ToolTurnsSinceCompact   int
}

type Reason string

type Selection struct {
	ForSummary []Message
	Preserved  []Message
	// GroupsPreserved 保留的组数（0 = 全量摘要）。
	GroupsPreserved int
	TotalGroups     int
}

type SummaryOptions struct {
	// RecentPreserved 保留近期消息时声明（模型不必向用户复述摘要）。
	RecentPreserved bool
	// SuppressFollowup 直接续跑（不确认摘要、不复述、不打招呼）。
	SuppressFollowup bool
	// TranscriptPath 全量转写落盘路径（需要精确原文时按需读）。
	TranscriptPath string
}

type TokenOverride struct {
	TokenCount int // 必填：provider 报告的输入侧总量
	CacheRead  int // 可观测用
	CacheWrite int
	Output     int
}

type TokenSource string

type ToolCall struct {
	ID       string
	Name     string
	ArgsJSON string
}