profiles

type AutoReplyConfig struct {
	// Enabled turns on auto-reply mode.
	Enabled bool

	// CommentaryMode controls inter-tool commentary verbosity.
	CommentaryMode CommentaryMode

	// InterToolDelay is the delay between tool executions for readability.
	InterToolDelay time.Duration

	// PersistCommentary saves commentary to the session for later review.
	PersistCommentary bool

	// MaxRounds limits the number of autonomous rounds before pausing.
	MaxRounds int

	// PauseOnError pauses auto-reply on tool errors.
	PauseOnError bool

	// PauseOnAmbiguity pauses when the agent is uncertain.
	PauseOnAmbiguity bool

	// NotifyOnCompletion sends a notification when auto-reply completes.
	NotifyOnCompletion bool

	// Callbacks for various auto-reply events.
	OnStart      func(ctx context.Context)
	OnRound      func(ctx context.Context, round int)
	OnPause      func(ctx context.Context, reason string)
	OnComplete   func(ctx context.Context)
	OnCommentary func(ctx context.Context, c *Commentary)
}

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

type AutoReplyState struct {
	// Active indicates if auto-reply is currently running.
	Active bool

	// StartTime is when the auto-reply session started.
	StartTime time.Time

	// CurrentRound is the current round number.
	CurrentRound int

	// TotalRounds is the total number of rounds executed.
	TotalRounds int

	// ToolsExecuted counts the tools executed.
	ToolsExecuted int

	// LastError holds the last error encountered.
	LastError error

	// PauseReason explains why auto-reply is paused.
	PauseReason string

	// Commentary contains the accumulated commentary.
	Commentary []*Commentary
}

type BootstrapProfile struct {
	// Name is the unique identifier for this profile.
	Name string

	// Description provides a human-readable description of the profile.
	Description string

	// SystemPrompt overrides the agent's default system prompt.
	// If empty, the agent's configured system prompt is used.
	SystemPrompt string

	// SystemPromptPrefix is prepended to the system prompt.
	SystemPromptPrefix string

	// SystemPromptSuffix is appended to the system prompt.
	SystemPromptSuffix string

	// AllowedTools limits which tools are available to the agent.
	// If empty, all registered tools are available.
	AllowedTools []string

	// DeniedTools prevents specific tools from being used.
	// Takes precedence over AllowedTools.
	DeniedTools []string

	// MaxContextMessages limits the conversation history length.
	// Zero means use the agent's default.
	MaxContextMessages int

	// MaxContextTokens limits the total token count in context.
	// Zero means use the agent's default.
	MaxContextTokens int

	// Temperature overrides the LLM temperature setting.
	// Nil means use the agent's default.
	Temperature *float64

	// MaxTokens overrides the LLM max tokens setting.
	// Nil means use the agent's default.
	MaxTokens *int

	// Model overrides the LLM model.
	// Empty means use the agent's default.
	Model string

	// ToolPolicies defines per-tool configuration.
	ToolPolicies map[string]ToolPolicy

	// OnInit is called when the profile is activated.
	OnInit func(ctx context.Context) error

	// OnClose is called when the profile is deactivated.
	OnClose func(ctx context.Context) error

	// Metadata holds arbitrary profile-specific data.
	Metadata map[string]any
}

type Commentary struct {
	// ID is a unique identifier for this commentary.
	ID string `json:"id"`

	// Type identifies the type of commentary.
	Type CommentaryType `json:"type"`

	// Content is the commentary text.
	Content string `json:"content"`

	// ToolName is the associated tool name (for tool-related commentary).
	ToolName string `json:"tool_name,omitempty"`

	// Timestamp is when the commentary was created.
	Timestamp time.Time `json:"timestamp"`

	// Metadata contains additional key-value data.
	Metadata map[string]any `json:"metadata,omitempty"`
}

type CommentaryCallback func(*Commentary)

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

type CommentaryMode int

type CommentaryType string

type LeanLevel int

type LeanMode struct {
	// Enabled activates lean mode optimizations.
	Enabled bool

	// Level controls the aggressiveness of optimizations.
	// Higher levels reduce more resources but may impact quality.
	Level LeanLevel

	// MaxContextTokens limits the context window size.
	// Lower values reduce memory usage.
	MaxContextTokens int

	// MaxResponseTokens limits the response length.
	MaxResponseTokens int

	// DisableTools disables all tool usage when true.
	DisableTools bool

	// ToolAllowlist limits which tools are available.
	// Empty means all tools (unless DisableTools is true).
	ToolAllowlist []string

	// DisableHistory prevents storing conversation history.
	DisableHistory bool

	// CompactPrompts removes whitespace and shortens prompts.
	CompactPrompts bool

	// SkipSystemPrompt omits the system prompt to save tokens.
	SkipSystemPrompt bool

	// BatchSize controls how many messages to process at once.
	// Lower values reduce peak memory usage.
	BatchSize int

	// StreamingDisabled prevents streaming responses.
	// Useful when streaming adds overhead.
	StreamingDisabled bool

	// CacheDisabled prevents caching of responses.
	CacheDisabled bool
}

type LeanModeConfig struct {
	// Level is the lean mode level.
	Level LeanLevel

	// CustomSettings override the level defaults.
	CustomSettings *LeanMode

	// ModelSpecific maps model names to lean mode settings.
	// Allows different settings per model.
	ModelSpecific map[string]*LeanMode
}

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

type ProfileSession struct {
	Profile *BootstrapProfile
	Active  bool
}

type ProgressCallback func(progress *ToolProgress)

type ProgressConfig struct {
	// Mode is the detail level for progress output.
	Mode ProgressDetailMode

	// Output is where progress is written (default: os.Stderr).
	Output io.Writer

	// ToolModes allows per-tool mode overrides.
	ToolModes map[string]ProgressDetailMode

	// Callbacks receive progress updates.
	Callbacks []ProgressCallback
}

type ProgressDetailMode int

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

type ToolPolicy struct {
	// Enabled controls whether the tool is available.
	Enabled bool

	// RateLimit is the maximum calls per minute. Zero means unlimited.
	RateLimit int

	// Timeout overrides the tool's default timeout in seconds.
	// Zero means use the tool's default.
	Timeout int

	// RequiresConfirmation indicates the user must confirm before execution.
	RequiresConfirmation bool
}

type ToolProgress struct {
	// ToolName is the name of the tool being executed.
	ToolName string

	// Status is the current execution status.
	Status ToolProgressStatus

	// StartTime is when the tool started executing.
	StartTime time.Time

	// EndTime is when the tool finished executing.
	EndTime time.Time

	// Parameters are the tool input parameters (may be redacted).
	Parameters map[string]any

	// Result is the tool output (may be truncated).
	Result string

	// Error is any error that occurred.
	Error string

	// BytesProcessed is the number of bytes processed (for streaming tools).
	BytesProcessed int64

	// Progress is the completion percentage (0-100) if known.
	Progress int

	// Message is a human-readable status message.
	Message string
}

type ToolProgressStatus string