agent

type AgentConfig struct {
	Providers     providers.ProviderGetter
	Registry      *tools.Registry
	Model         ai.Model
	APIKey        string
	BaseURL       string
	System        string
	Emit          func(agent.LoopEvent) // optional event emitter for observability
	Presets       *PresetRegistry       // loaded agent presets (nil = no presets)
	Hooks         *hooks.HookSet        // inherited by subagents (nil = no hooks)
	ToolLifecycle *agent.ToolLifecycle

	// Configurable limits (zero = use defaults).
	MaxConcurrency int           // max parallel subagent goroutines
	DefaultTimeout time.Duration // default subagent wall-clock timeout (0 = 15m)
}

type AgentPreset struct {
	Name        string        // unique identifier
	Description string        // human-readable description
	System      string        // markdown body = system prompt for the subagent
	Tools       []string      // nil = all tools; empty slice = no tools
	HasTools    bool          // true when tools is explicitly set (even if empty)
	Timeout     time.Duration // wall-clock timeout override; 0 = use global default
	Model       string        // empty = inherit parent model
	FilePath    string        // absolute path to the source .md file
	Source      string        // "project", "agent", "common", or "builtin"
}

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

type LoadAgentPresetsConfig struct {
	StellaHome  string // stella home dir (e.g. ~/.stella)
	AgentRoot   string // agent root dir (e.g. ~/.stella/workspaces/{agentID})
	UserRoot    string // user root dir (e.g. ~/.stella/workspaces/{agentID}/users/{userID})
	ProjectRoot string // optional project root for local/project-attached runs
}

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

type SubAgentFinished struct {
	TaskID   string        `json:"taskId"`
	Duration time.Duration `json:"duration"`
	Error    string        `json:"error,omitempty"`
}

type SubAgentStarted struct {
	TaskID string `json:"taskId"`
	Preset string `json:"preset,omitempty"`
}