config

type DashboardConfig struct {
	// Enabled activates the admin dashboard. Disabled by default.
	Enabled bool `yaml:"enabled,omitempty" toml:"enabled,omitempty"`
	// RefreshInterval is the dashboard auto-refresh interval in seconds.
	// The frontend polls GET /api/v1/dashboard at this rate. Defaults to 30.
	RefreshInterval int `yaml:"refresh_interval,omitempty" toml:"refresh_interval,omitempty"`
}

type DryRunConfig struct {
	// Enabled activates dry-run simulation. When true, write tools are
	// wrapped to simulate execution without side-effects.
	Enabled bool `yaml:"enabled,omitempty" toml:"enabled,omitempty"`
}

type FeaturesConfig struct {
	// DryRun enables dry-run simulation mode. When true, write tools are
	// wrapped to simulate execution without side-effects. Useful for
	// testing and auditing agent behavior before going live.
	DryRun DryRunConfig `yaml:"dry_run,omitempty" toml:"dry_run,omitempty"`

	// Dashboard enables the admin/ops dashboard (GET /api/v1/dashboard
	// and /ui/admin.html). The route is always registered; when
	// disabled (default) the handler returns a JSON 404 with zero
	// collection overhead.
	Dashboard DashboardConfig `yaml:"dashboard,omitempty" toml:"dashboard,omitempty"`

	// SubAgents configures opt-out guardrails for sub-agent behavior,
	// such as controlling huge tool output limits and PII safety.
	SubAgents SubAgentsConfig `yaml:"sub_agents,omitempty" toml:"sub_agents,omitempty"`
}

type GenieConfig struct {
	// AgentName is the user-chosen name for the agent. It gives the agent a
	// personality and is used for the default audit log path
	// (~/.genie/{agent_name}.<yyyy_mm_dd>.ndjson).
	AgentName string `yaml:"agent_name,omitempty" toml:"agent_name,omitempty"`
	// Persona configures the project-level coding standards and agent capabilities file.
	Persona PersonaConfig `yaml:"persona,omitempty" toml:"persona,omitempty"`
	// PersonaTokenThreshold is the maximum recommended token length for the
	// persona/system prompt. If exceeded at boot, a warning is emitted.
	// Defaults to 2000.
	PersonaTokenThreshold int `yaml:"persona_token_threshold,omitempty" toml:"persona_token_threshold,omitempty"`
	// AuditPath overrides the default audit log path. When set, the auditor
	// writes to this single file (no date rotation). Used for tests or custom paths.
	AuditPath       string                    `yaml:"audit_path,omitempty" toml:"audit_path,omitempty"`
	ModelConfig     modelprovider.ModelConfig `yaml:"model_config,omitempty" toml:"model_config,omitempty"`
	SkillLoadConfig tools.SkillLoadConfig     `yaml:"skill_load,omitempty" toml:"skill_load,omitempty"`
	MCP             mcp.MCPConfig             `yaml:"mcp,omitempty" toml:"mcp,omitempty"`
	WebSearch       websearch.Config          `yaml:"web_search,omitempty" toml:"web_search,omitempty"`
	VectorMemory    vector.Config             `yaml:"vector_memory,omitempty" toml:"vector_memory,omitempty"`
	Graph           graph.Config              `yaml:"graph,omitempty" toml:"graph,omitempty"`
	Messenger       messenger.Config          `yaml:"messenger,omitempty" toml:"messenger,omitempty"`
	Browser         browser.Config            `yaml:"browser,omitempty" toml:"browser,omitempty"`
	SCM             scm.Config                `yaml:"scm,omitempty" toml:"scm,omitempty"`
	ExecutableTools executable.Configs        `yaml:"executable_tools,omitempty" toml:"executable_tools,omitempty"`

	ProjectManagement pm.Config `yaml:"project_management,omitempty" toml:"project_management,omitempty"`

	Email        email.Config        `yaml:"email,omitempty" toml:"email,omitempty"`
	GDrive       gdrive.Config       `yaml:"google_drive,omitempty" toml:"google_drive,omitempty"`
	Notification notification.Config `yaml:"notification,omitempty" toml:"notification,omitempty"`
	HITL         hitl.Config         `yaml:"hitl,omitempty" toml:"hitl,omitempty"`
	DBConfig     db.Config           `yaml:"db_config,omitempty" toml:"db_config,omitempty"`
	Langfuse     langfuse.Config     `yaml:"langfuse,omitempty" toml:"langfuse,omitempty"`

	Cron cron.Config `yaml:"cron,omitempty" toml:"cron,omitempty"`
	// Unified data sources configuration
	DataSources datasource.Config `yaml:"data_sources,omitempty" toml:"data_sources,omitempty"`

	// DocParser configures the multi-backend document parser used to convert
	// files (PDF, DOCX, images) into NormalizedItems for vectorization.
	DocParser docparser.Config `yaml:"doc_parser,omitempty" toml:"doc_parser,omitempty"`

	Security security.Config           `yaml:"security,omitempty" toml:"security,omitempty"`
	PII      pii.Config                `yaml:"pii,omitempty" toml:"pii,omitempty"`
	Toolwrap toolwrap.MiddlewareConfig `yaml:"toolwrap,omitempty" toml:"toolwrap,omitempty"`

	// ShellTool configures the run_shell tool's security behaviour.
	// Use shell_tool.allowed_env to control which environment variables
	// are visible to shell commands (principle of least privilege). When
	// shell_tool.allowed_env is unset or empty, only PATH is exposed to
	// shell commands; any additional environment variables must be listed
	// explicitly.
	ShellTool unixtools.ShellToolConfig `yaml:"shell_tool,omitempty" toml:"shell_tool,omitempty"`

	// DisablePensieve disables the Pensieve context management tools
	// (delete_context, check_budget, note, read_notes) from arXiv:2602.12108.
	// When true, the agent can actively manage its own context window.
	// delete_context and note require HITL approval; check_budget and
	// read_notes are read-only and auto-approved.
	DisablePensieve bool `yaml:"disable_pensieve,omitempty" toml:"disable_pensieve,omitempty"`

	// HalGuard configures the hallucination guard that validates
	// sub-agent goals (pre-check) and outputs (post-check).
	// See halguard.DefaultConfig() for defaults.
	HalGuard halguard.Config `yaml:"halguard,omitempty" toml:"halguard,omitempty"`

	// SemanticRouter configures the fast embedding-based intent routing,
	// jailbreak detection, and response semantic caching.
	SemanticRouter semanticrouter.Config `yaml:"semantic_router,omitempty" toml:"semantic_router,omitempty"`

	// Features holds opt-in feature toggles for enterprise capabilities
	// such as dry-run simulation. Tool blocking is handled by HITL.
	Features FeaturesConfig `yaml:"features,omitempty" toml:"features,omitempty"`

	// Learning configures the post-session learning loop that distills
	// completed tasks into reusable skills.
	Learning LearningConfig `yaml:"learning,omitempty" toml:"learning,omitempty"`
}

type LearningConfig struct {
	// MinimumNoveltyScore is the LLM-assigned novelty score (1-10) above
	// which a completed task is considered novel enough to distill into a
	// reusable skill. Lower values create more skills; higher values are
	// more selective. Default is 7.
	MinimumNoveltyScore int `yaml:"minimum_novelty_score,omitempty" toml:"minimum_novelty_score,omitempty"`
}

type PersonaConfig struct {
	// File is an optional path to a file whose contents are appended
	// to the agent's system prompt as project-level coding standards.
	// When empty, no persona content is loaded.
	File string `yaml:"file,omitempty" toml:"file,omitempty"`

	// DisableResume makes the generation of the agent's resume optional.
	// If disabled, the persona file is used as is.
	DisableResume bool `yaml:"disable_resume,omitempty" toml:"disable_resume,omitempty"`

	// AccomplishmentConfidenceThreshold is the minimum confidence score
	// (0.0–1.0) required for a tree result to be stored as an accomplishment.
	// Results below this threshold are discarded to prevent storing
	// error outputs or low-quality responses. Default is 0.5.
	AccomplishmentConfidenceThreshold float64 `yaml:"accomplishment_confidence_threshold,omitempty" toml:"accomplishment_confidence_threshold,omitempty"`
}

type SubAgentsConfig struct {
	// DisableToolResultTruncation, if true, disables 8k-byte truncation on raw tool results going into working memory.
	DisableToolResultTruncation bool `yaml:"disable_tool_result_truncation,omitempty" toml:"disable_tool_result_truncation,omitempty"`

	// DisableNoteNamespacing, if true, prevents agent names from being prepended to propagated notes.
	DisableNoteNamespacing bool `yaml:"disable_note_namespacing,omitempty" toml:"disable_note_namespacing,omitempty"`

	// DisableNotePIIRedaction, if true, disables PII redaction on notes propagated to the orchestrator.
	DisableNotePIIRedaction bool `yaml:"disable_note_pii_redaction,omitempty" toml:"disable_note_pii_redaction,omitempty"`
}