profiles

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 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