agents

type AgentDefinition struct {
	ID          string `json:"id"`
	Name        string `json:"name"`
	Description string `json:"description,omitempty"`
	AvatarURL   string `json:"avatar_url,omitempty"`

	// Model selection (like pi-agent)
	Model ModelConfig `json:"model"`

	// System prompt (base, sections added dynamically)
	SystemPrompt string     `json:"system_prompt,omitempty"`
	PromptMode   PromptMode `json:"prompt_mode,omitempty"` // full, minimal, none

	// Tool policy (OpenClaw-style)
	Tools *toolpolicy.ToolPolicyConfig `json:"tools,omitempty"`

	// Subagent defaults (OpenClaw-style)
	Subagents *SubagentConfig `json:"subagents,omitempty"`

	// Agent behavior
	Temperature     float64      `json:"temperature,omitempty"`
	ReasoningEffort string       `json:"reasoning_effort,omitempty"` // none, low, medium, high
	ResponseMode    ResponseMode `json:"response_mode,omitempty"`    // natural (OpenClaw-style), raw (pass-through)
	Identity        *Identity    `json:"identity,omitempty"`         // custom identity for prompt
	HeartbeatPrompt string       `json:"heartbeat_prompt,omitempty"` // prompt for heartbeat polling (clawdbot parity)

	// Memory search configuration override (OpenClaw-style)
	MemorySearch *MemorySearchConfig `json:"memory_search,omitempty"`

	// Metadata
	IsPreset  bool  `json:"is_preset,omitempty"`
	CreatedAt int64 `json:"created_at"`
	UpdatedAt int64 `json:"updated_at"`
}

type AgentStore interface {
	// LoadAgents returns all agents for the current user.
	LoadAgents(ctx context.Context) (map[string]*AgentDefinition, error)

	// SaveAgent creates or updates an agent.
	SaveAgent(ctx context.Context, agent *AgentDefinition) error

	// DeleteAgent removes a custom agent.
	DeleteAgent(ctx context.Context, agentID string) error

	// ListModels returns available AI models.
	ListModels(ctx context.Context) ([]ModelInfo, error)

	// ListAvailableTools returns available tools.
	ListAvailableTools(ctx context.Context) ([]tools.ToolInfo, error)
}

type ElevatedInfo struct {
	Allowed      bool
	DefaultLevel string // "on" | "off" | "ask" | "full"
}

type EmbeddedContextFile struct {
	Path    string
	Content string
}

type Identity struct {
	Name    string `json:"name,omitempty"`
	Persona string `json:"persona,omitempty"`
}

type IdentityFile struct {
	Name     string
	Emoji    string
	Theme    string
	Creature string
	Vibe     string
	Avatar   string
}

type MemorySearchBatchConfig struct {
	Enabled        *bool `json:"enabled,omitempty"`
	Wait           *bool `json:"wait,omitempty"`
	Concurrency    int   `json:"concurrency,omitempty"`
	PollIntervalMs int   `json:"poll_interval_ms,omitempty"`
	TimeoutMinutes int   `json:"timeout_minutes,omitempty"`
}

type MemorySearchCacheConfig struct {
	Enabled    *bool `json:"enabled,omitempty"`
	MaxEntries int   `json:"max_entries,omitempty"`
}

type MemorySearchChunkingConfig struct {
	Tokens  int `json:"tokens,omitempty"`
	Overlap int `json:"overlap,omitempty"`
}

type MemorySearchConfig struct {
	Enabled      *bool                           `json:"enabled,omitempty"`
	Sources      []string                        `json:"sources,omitempty"`
	ExtraPaths   []string                        `json:"extra_paths,omitempty"`
	Provider     string                          `json:"provider,omitempty"`
	Model        string                          `json:"model,omitempty"`
	Remote       *MemorySearchRemoteConfig       `json:"remote,omitempty"`
	Fallback     string                          `json:"fallback,omitempty"`
	Store        *MemorySearchStoreConfig        `json:"store,omitempty"`
	Chunking     *MemorySearchChunkingConfig     `json:"chunking,omitempty"`
	Sync         *MemorySearchSyncConfig         `json:"sync,omitempty"`
	Query        *MemorySearchQueryConfig        `json:"query,omitempty"`
	Cache        *MemorySearchCacheConfig        `json:"cache,omitempty"`
	Experimental *MemorySearchExperimentalConfig `json:"experimental,omitempty"`
}

type MemorySearchExperimentalConfig struct {
	SessionMemory *bool `json:"session_memory,omitempty"`
}

type MemorySearchHybridConfig struct {
	Enabled             *bool   `json:"enabled,omitempty"`
	VectorWeight        float64 `json:"vector_weight,omitempty"`
	TextWeight          float64 `json:"text_weight,omitempty"`
	CandidateMultiplier int     `json:"candidate_multiplier,omitempty"`
}

type MemorySearchQueryConfig struct {
	MaxResults       int                       `json:"max_results,omitempty"`
	MinScore         float64                   `json:"min_score,omitempty"`
	MaxInjectedChars int                       `json:"max_injected_chars,omitempty"`
	Hybrid           *MemorySearchHybridConfig `json:"hybrid,omitempty"`
}

type MemorySearchRemoteConfig struct {
	BaseURL string                   `json:"base_url,omitempty"`
	APIKey  string                   `json:"api_key,omitempty"`
	Headers map[string]string        `json:"headers,omitempty"`
	Batch   *MemorySearchBatchConfig `json:"batch,omitempty"`
}

type MemorySearchSessionSyncConfig struct {
	DeltaBytes    int `json:"delta_bytes,omitempty"`
	DeltaMessages int `json:"delta_messages,omitempty"`
	RetentionDays int `json:"retention_days,omitempty"`
}

type MemorySearchStoreConfig struct {
	Driver string                    `json:"driver,omitempty"`
	Path   string                    `json:"path,omitempty"`
	Vector *MemorySearchVectorConfig `json:"vector,omitempty"`
}

type MemorySearchSyncConfig struct {
	OnSessionStart  *bool                          `json:"on_session_start,omitempty"`
	OnSearch        *bool                          `json:"on_search,omitempty"`
	Watch           *bool                          `json:"watch,omitempty"`
	WatchDebounceMs int                            `json:"watch_debounce_ms,omitempty"`
	IntervalMinutes int                            `json:"interval_minutes,omitempty"`
	Sessions        *MemorySearchSessionSyncConfig `json:"sessions,omitempty"`
}

type MemorySearchVectorConfig struct {
	Enabled       *bool  `json:"enabled,omitempty"`
	ExtensionPath string `json:"extension_path,omitempty"`
}

type ModelConfig struct {
	Primary   string   `json:"primary"`             // e.g., "anthropic/claude-sonnet-4.5"
	Fallbacks []string `json:"fallbacks,omitempty"` // fallback chain
}

type ModelInfo struct {
	ID          string `json:"id"`
	Name        string `json:"name"`
	Provider    string `json:"provider,omitempty"`
	Description string `json:"description,omitempty"`

	// Capabilities
	SupportsVision        bool `json:"supports_vision,omitempty"`
	SupportsTools         bool `json:"supports_tools,omitempty"`
	SupportsReasoning     bool `json:"supports_reasoning,omitempty"`
	SupportsStreaming     bool `json:"supports_streaming,omitempty"`
	SupportsCodeExecution bool `json:"supports_code_execution,omitempty"`
	SupportsWebSearch     bool `json:"supports_web_search,omitempty"`

	// Limits
	MaxContextTokens    int `json:"max_context_tokens,omitempty"`
	MaxCompletionTokens int `json:"max_completion_tokens,omitempty"`
}

type PromptMode string

type ReactionGuidance struct {
	Level   string // "minimal" or "extensive"
	Channel string // e.g., "matrix", "signal"
}

type ResolvedTimeFormat string

type ResponseMode string

type RuntimeInfo struct {
	AgentID      string   // Current agent ID
	Host         string   // Hostname
	OS           string   // Host OS
	Arch         string   // Host architecture
	Node         string   // Runtime version (OpenClaw uses Node)
	Model        string   // Current model being used
	DefaultModel string   // Default model for the provider
	Channel      string   // Communication channel
	Capabilities []string // Runtime capabilities
	RepoRoot     string   // Repo root path
}

type SandboxInfo struct {
	Enabled             bool
	WorkspaceDir        string
	WorkspaceAccess     string // "none", "ro", "rw"
	AgentWorkspaceMount string
	BrowserBridgeURL    string
	BrowserNoVncURL     string
	HostBrowserAllowed  *bool
	Elevated            *ElevatedInfo
}

type SoulEvilCheckParams struct {
	Config       *SoulEvilConfig
	UserTimezone string
	Now          time.Time
	Random       func() float64
}

type SoulEvilConfig struct {
	File   string         `yaml:"file" json:"file,omitempty"`
	Chance float64        `yaml:"chance" json:"chance,omitempty"`
	Purge  *SoulEvilPurge `yaml:"purge" json:"purge,omitempty"`
}

type SoulEvilDecision struct {
	UseEvil  bool
	Reason   string
	FileName string
}

type SoulEvilPurge struct {
	At       string `yaml:"at" json:"at,omitempty"`
	Duration string `yaml:"duration" json:"duration,omitempty"`
}

type StripHeartbeatMode string

type SubagentConfig struct {
	Model       string   `json:"model,omitempty"`
	Thinking    string   `json:"thinking,omitempty"`
	AllowAgents []string `json:"allowAgents,omitempty"`
}

type SubagentPromptParams struct {
	RequesterSessionKey string // Session key of the agent that spawned this subagent
	RequesterChannel    string // Channel the requester is on (e.g., "matrix", "signal")
	ChildSessionKey     string // Session key of this subagent
	Label               string // Optional label for the task
	Task                string // Description of the task to complete
}

type SystemPromptParams struct {
	WorkspaceDir           string
	DefaultThinkLevel      string
	ReasoningLevel         string
	ExtraSystemPrompt      string
	OwnerNumbers           []string
	ReasoningTagHint       bool
	ToolNames              []string
	ToolSummaries          map[string]string
	ModelAliasLines        []string
	UserTimezone           string
	UserTime               string
	UserTimeFormat         ResolvedTimeFormat
	ContextFiles           []EmbeddedContextFile
	SkillsPrompt           string
	HeartbeatPrompt        string
	WorkspaceNotes         []string
	TTSHint                string
	PromptMode             PromptMode
	RuntimeInfo            *RuntimeInfo
	MessageToolHints       []string
	SandboxInfo            *SandboxInfo
	ReactionGuidance       *ReactionGuidance
	MemoryCitations        string
	UserIdentitySupplement string
}

type TrimBootstrapResult struct {
	Content        string
	Truncated      bool
	MaxChars       int
	OriginalLength int
}

type WorkspaceBootstrapFile struct {
	Name    string
	Path    string
	Content string
	Missing bool
}