context

type AgentCapabilities struct {
	SupportsBuiltinCompact bool
	SupportsHistoryClear   bool
	BuiltinCompactCommand  string // e.g., "/compact"
	HistoryClearCommand    string // e.g., "/clear"
}

type AgentContextInfo struct {
	AgentID     string           `json:"agent_id"`
	PaneID      string           `json:"pane_id"`
	Model       string           `json:"model"`
	Estimate    *ContextEstimate `json:"estimate"`
	NeedsWarn   bool             `json:"needs_warning"`
	NeedsRotate bool             `json:"needs_rotation"`
}

type BudgetAllocation struct {
	Triage int // 10%
	CM     int // 5%
	CASS   int // 15%
	S2P    int // 70%
}

type BuildOptions struct {
	BeadID        string
	AgentType     string // cc, cod, gmi
	RepoRev       string
	Task          string   // Task description for CM context
	Files         []string // Files for S2P context
	CorrelationID string
	ProjectDir    string
	SessionID     string // For CM client connection
}

type CompactionCommand struct {
	Command     string // The command/text to send
	IsPrompt    bool   // True if this is a prompt, false if a slash command
	WaitTime    time.Duration
	Description string
}

type CompactionMethod string

type CompactionResult struct {
	Success         bool             `json:"success"`
	Method          CompactionMethod `json:"method"`
	TokensBefore    int64            `json:"tokens_before"`
	TokensAfter     int64            `json:"tokens_after"`
	TokensReclaimed int64            `json:"tokens_reclaimed"`
	UsageBefore     float64          `json:"usage_before"`
	UsageAfter      float64          `json:"usage_after"`
	Duration        time.Duration    `json:"duration"`
	Error           string           `json:"error,omitempty"`
}

type CompactionState struct {
	AgentID        string
	StartedAt      time.Time
	Method         CompactionMethod
	CommandsSent   int
	LastCommand    string
	WaitingUntil   time.Time
	EstimateBefore *ContextEstimate
}

type CompactionStatus struct {
	LastCompaction time.Time `json:"last_compaction"`
	IsCompacting   bool      `json:"is_compacting"`
	CooldownUntil  time.Time `json:"cooldown_until"`
}

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

type CompactionTriggerConfig struct {
	// PollInterval is how often to check predictions for compaction triggers
	PollInterval time.Duration
	// AutoCompact enables automatic compaction triggering
	AutoCompact bool
	// CompactionCooldown is minimum time between compaction attempts per agent
	CompactionCooldown time.Duration
	// WaitAfterCommand is how long to wait for compaction to complete
	WaitAfterCommand time.Duration
	// EnableRecoveryInjection controls whether to inject recovery context post-compaction
	EnableRecoveryInjection bool
}

type CompactionTriggerEvent struct {
	AgentID          string            `json:"agent_id"`
	PaneID           string            `json:"pane_id"`
	AgentType        tmux.AgentType    `json:"agent_type"`
	Prediction       *Prediction       `json:"prediction"`
	TriggeredAt      time.Time         `json:"triggered_at"`
	CompactionResult *CompactionResult `json:"compaction_result,omitempty"`
}

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

type CompactorConfig struct {
	MinReduction     float64       // Minimum usage reduction to consider success (default: 0.10)
	BuiltinTimeout   time.Duration // Timeout for builtin compaction (default: 10s)
	SummarizeTimeout time.Duration // Timeout for summarization (default: 30s)
}

type ConfirmAction string

type ContextEstimate struct {
	TokensUsed   int64            `json:"tokens_used"`
	ContextLimit int64            `json:"context_limit"`
	UsagePercent float64          `json:"usage_percent"` // 0.0-100.0
	Confidence   float64          `json:"confidence"`    // 0.0-1.0
	Method       EstimationMethod `json:"method"`
	Model        string           `json:"model,omitempty"`
	UpdatedAt    time.Time        `json:"updated_at"`
}

type ContextEstimator interface {
	// Estimate computes a context usage estimate for the given agent.
	Estimate(state *ContextState) (*ContextEstimate, error)

	// Confidence returns the base confidence level for this strategy.
	Confidence() float64

	// Name returns the strategy name for logging.
	Name() string
}

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

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

type ContextPackFull struct {
	state.ContextPack
	Components map[string]*PackComponent `json:"components,omitempty"`
}

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

type ContextState struct {
	AgentID        string           `json:"agent_id"`
	PaneID         string           `json:"pane_id"`
	Model          string           `json:"model"`
	AgentType      string           `json:"agent_type,omitempty"` // cc, cod, gmi
	SessionName    string           `json:"session_name,omitempty"`
	TranscriptPath string           `json:"transcript_path,omitempty"` // Path to agent's transcript file
	Estimate       *ContextEstimate `json:"estimate"`
	MessageCount   int              `json:"message_count"`
	SessionStart   time.Time        `json:"session_start"`
	LastActivity   time.Time        `json:"last_activity"`
	// contains filtered or unexported fields
}

type CumulativeTokenEstimator struct {
	CompactionDiscount float64 // Factor to apply for expected compaction, default 0.7
}

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

type DurationActivityEstimator struct {
	TokensPerMinuteActive   int // Tokens consumed per minute of active conversation
	TokensPerMinuteInactive int // Tokens for inactive time (system overhead)
}

type EstimationMethod string

type HandoffRecommendation struct {
	ShouldTrigger bool    // True if handoff should be triggered
	ShouldWarn    bool    // True if warning threshold exceeded
	Reason        string  // Human-readable reason for the recommendation
	UsagePercent  float64 // Current usage percentage
	TokenVelocity float64 // Tokens per minute (if available)
}

type HandoffStatus struct {
	LastHandoff   time.Time `json:"last_handoff"`
	IsGenerating  bool      `json:"is_generating"`
	CooldownUntil time.Time `json:"cooldown_until"`
}

type HandoffSummary struct {
	GeneratedAt   time.Time `json:"generated_at"`
	OldAgentID    string    `json:"old_agent_id"`
	OldAgentType  string    `json:"old_agent_type,omitempty"`
	SessionName   string    `json:"session_name,omitempty"`
	CurrentTask   string    `json:"current_task"`
	Progress      string    `json:"progress"`
	KeyDecisions  []string  `json:"key_decisions,omitempty"`
	ActiveFiles   []string  `json:"active_files,omitempty"`
	Blockers      []string  `json:"blockers,omitempty"`
	RawSummary    string    `json:"raw_summary"`
	TokenEstimate int       `json:"token_estimate"`
}

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

type HandoffTriggerConfig struct {
	// PollInterval is how often to check agents for handoff triggers
	PollInterval time.Duration
	// WarnThreshold is the usage percentage for warning callbacks (default 70%)
	WarnThreshold float64
	// TriggerThreshold is the usage percentage for handoff generation (default 75%)
	TriggerThreshold float64
	// Cooldown is minimum time between handoffs per agent
	Cooldown time.Duration
	// ProjectDir is the project directory for handoff generation
	ProjectDir string
}

type HandoffTriggerEvent struct {
	AgentID      string    `json:"agent_id"`
	PaneID       string    `json:"pane_id"`
	AgentType    string    `json:"agent_type"`
	SessionName  string    `json:"session_name"`
	UsagePercent float64   `json:"usage_percent"`
	Reason       string    `json:"reason"`
	HandoffPath  string    `json:"handoff_path,omitempty"`
	TriggeredAt  time.Time `json:"triggered_at"`
	Error        string    `json:"error,omitempty"`
}

type MessageCountEstimator struct {
	TokensPerMessage int // Average tokens per message, default 1500
}

type MonitorConfig struct {
	WarningThreshold float64 // Percentage at which to warn (default 70)
	RotateThreshold  float64 // Percentage at which to rotate (default 75)
	TokensPerMessage int     // For message count estimation (default 1500)
}

type PackComponent struct {
	Type       string          `json:"type"`
	Data       json.RawMessage `json:"data,omitempty"`
	TokenCount int             `json:"token_count"`
	Error      string          `json:"error,omitempty"`
}

type PaneSpawner interface {
	// SpawnAgent creates a new agent pane and returns its ID.
	SpawnAgent(session, agentType string, index int, variant string, workDir string) (paneID string, err error)
	// KillPane terminates a pane.
	KillPane(paneID string) error
	// SendKeys sends text to a pane.
	SendKeys(paneID, text string, enter bool) error
	// GetPanes returns all panes in a session.
	GetPanes(session string) ([]tmux.Pane, error)
}

type PendingRotation struct {
	AgentID        string        `json:"agent_id"`
	SessionName    string        `json:"session_name"`
	PaneID         string        `json:"pane_id"`
	ContextPercent float64       `json:"context_percent"`
	CreatedAt      time.Time     `json:"created_at"`
	TimeoutAt      time.Time     `json:"timeout_at"`
	DefaultAction  ConfirmAction `json:"default_action"`
	WorkDir        string        `json:"-"` // Not serialized
}

type PendingRotationOutput struct {
	Type             string   `json:"type"`
	AgentID          string   `json:"agent_id"`
	SessionName      string   `json:"session_name"`
	ContextPercent   float64  `json:"context_percent"`
	AwaitingConfirm  bool     `json:"awaiting_confirmation"`
	TimeoutSeconds   int      `json:"timeout_seconds"`
	DefaultAction    string   `json:"default_action"`
	AvailableActions []string `json:"available_actions"`
	GeneratedAt      string   `json:"generated_at"`
}

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

type Prediction struct {
	CurrentUsage        float64 // Current usage as percentage (0.0-1.0)
	CurrentTokens       int64   // Current token count
	ContextLimit        int64   // Model context limit
	TokenVelocity       float64 // Tokens per minute (positive = growing)
	MinutesToExhaustion float64 // Estimated minutes until exhaustion (0 if stable/decreasing)
	ShouldWarn          bool    // True if warning threshold met
	ShouldCompact       bool    // True if compaction threshold met
	SampleCount         int     // Number of samples used for prediction
	WindowDuration      float64 // Actual window duration in minutes
}

type PredictorConfig struct {
	Window         time.Duration // Velocity averaging window
	PollInterval   time.Duration // Polling interval
	MaxSamples     int           // Maximum samples to retain
	WarnMinutes    float64       // Minutes threshold for warning
	WarnUsage      float64       // Usage threshold for warning
	CompactMinutes float64       // Minutes threshold for compaction
	CompactUsage   float64       // Usage threshold for compaction
	MinSamples     int           // Minimum samples for valid prediction
}

type RobotModeEstimator struct{}

type RotationEvent struct {
	SessionName   string         `json:"session_name"`
	OldAgentID    string         `json:"old_agent_id"`
	NewAgentID    string         `json:"new_agent_id"`
	AgentType     string         `json:"agent_type"`
	Method        RotationMethod `json:"method"`
	ContextBefore float64        `json:"context_before"` // Usage percentage before
	ContextAfter  float64        `json:"context_after"`  // Usage percentage after (should be ~0)
	SummaryTokens int            `json:"summary_tokens"`
	Duration      time.Duration  `json:"duration"`
	Timestamp     time.Time      `json:"timestamp"`
	Error         string         `json:"error,omitempty"`
}

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

type RotationMethod string

type RotationRecord struct {
	ID        string    `json:"id"`        // Unique ID for the record
	Timestamp time.Time `json:"timestamp"` // When rotation occurred

	// Session and Agent Info
	SessionName string `json:"session_name"`
	AgentID     string `json:"agent_id"`
	AgentType   string `json:"agent_type"`
	Profile     string `json:"profile,omitempty"` // Profile/persona name if any

	// Context state before rotation
	ContextBefore    float64 `json:"context_before_percent"` // Usage % before
	EstimationMethod string  `json:"estimation_method"`      // How usage was estimated

	// Compaction attempt
	CompactionTried  bool   `json:"compaction_tried"`
	CompactionResult string `json:"compaction_result,omitempty"` // "success", "failed", "skipped"
	CompactionMethod string `json:"compaction_method,omitempty"` // "builtin", "summarize", etc.

	// Rotation result
	Method        RotationMethod `json:"method"` // threshold, manual, etc.
	Success       bool           `json:"success"`
	FailureReason string         `json:"failure_reason,omitempty"`
	SummaryTokens int            `json:"summary_tokens"`
	ContextAfter  float64        `json:"context_after_percent"` // Usage % after (should be ~0)

	// Duration
	DurationMs int64 `json:"duration_ms"`
}

type RotationResult struct {
	Success       bool           `json:"success"`
	OldAgentID    string         `json:"old_agent_id"`
	NewAgentID    string         `json:"new_agent_id,omitempty"`
	OldPaneID     string         `json:"old_pane_id"`
	NewPaneID     string         `json:"new_pane_id,omitempty"`
	Method        RotationMethod `json:"method"`
	State         RotationState  `json:"state"`
	SummaryTokens int            `json:"summary_tokens,omitempty"`
	Duration      time.Duration  `json:"duration"`
	Error         string         `json:"error,omitempty"`
	Timestamp     time.Time      `json:"timestamp"`
}

type RotationState string

type RotationStats struct {
	TotalRotations   int     `json:"total_rotations"`
	SuccessCount     int     `json:"success_count"`
	FailureCount     int     `json:"failure_count"`
	UniqueSessions   int     `json:"unique_sessions"`
	AvgContextBefore float64 `json:"avg_context_before_percent"`
	AvgDurationMs    int64   `json:"avg_duration_ms"`
	FileSizeBytes    int64   `json:"file_size_bytes"`

	// By method
	ThresholdRotations int `json:"threshold_rotations"`
	ManualRotations    int `json:"manual_rotations"`

	// Compaction stats
	CompactionAttempts  int `json:"compaction_attempts"`
	CompactionSuccesses int `json:"compaction_successes"`

	// By agent type
	RotationsByAgentType map[string]int `json:"rotations_by_agent_type"`

	// By profile
	RotationsByProfile map[string]int `json:"rotations_by_profile,omitempty"`
}

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

type RotatorConfig struct {
	Monitor   *ContextMonitor
	Compactor *Compactor
	Summary   *SummaryGenerator
	Spawner   PaneSpawner
	Config    config.ContextRotationConfig
}

type StoredPendingRotation struct {
	AgentID        string        `json:"agent_id"`
	SessionName    string        `json:"session_name"`
	PaneID         string        `json:"pane_id"`
	ContextPercent float64       `json:"context_percent"`
	CreatedAt      time.Time     `json:"created_at"`
	TimeoutAt      time.Time     `json:"timeout_at"`
	DefaultAction  ConfirmAction `json:"default_action"`
	WorkDir        string        `json:"work_dir"`
}

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

type SummaryGeneratorConfig struct {
	MaxTokens     int           // Maximum tokens for summary (default: 2000)
	PromptTimeout time.Duration // Timeout for agent response (default: 30s)
}

type TokenSample struct {
	Timestamp time.Time
	Tokens    int64
}