sysprompt

type AgentDefinition struct {
	Name              string
	WhenToUse         string
	OmitMemory        bool
	AdvertiseSkills   bool
	BuildSystemPrompt func(ctx PromptContext) string

	// As controls where this agent appears. Values:
	//   "main"     — selectable via /profile (Phase 6 picker).
	//   "subagent" — invokable via the Agent tool's subagent_type.
	// Both can be set; for built-ins the slice is fixed (Main is main-only;
	// Explore/General are subagent-only). Disk agents declare this via
	// meta.yml's `as:` field.
	As []string

	// ActiveTools / DeferredTools name the tools this agent's profile loads.
	// Empty means "use the built-in constructor's default" (Main, Explore,
	// General supply their own lists in agent.Main/Explore/General). For
	// disk-loaded agents these come from tools.yml.
	ActiveTools   []tools.ToolName
	DeferredTools []tools.ToolName

	// Model is the optional model override declared in meta.yml. Empty
	// means "inherit from parent" (existing built-in behavior).
	Model string

	// OutputStyle is the optional output style declared in meta.yml. When
	// set it wins over the user's configured output_style while this
	// persona is active (PRD output-styles §5.5). Empty for built-ins.
	OutputStyle string

	// PromptBody is the raw persona prompt body before composition, set when
	// the definition came from disk (system_prompt.md) or a public AgentSpec.
	// Empty for built-ins whose prompt is assembled from internal fragments —
	// their prompt isn't recoverable as a single string. Lets a definition
	// round-trip back to a public AgentDefinition for inspection.
	PromptBody string

	// LongRunning marks a persona that stays live for a very long time — a swarm
	// member runs for weeks. The prompt builder then drops fragments that would
	// drift across rebuilds and bust the prompt-cache prefix: currently the
	// "- Today:" date in the environment section (gated via PromptContext.OmitDate
	// in mainProfileFromDiskAgent). Built-in evva leaves it false; internal/swarm
	// sets it at member registration (RP-5).
	LongRunning bool

	// PromptSuffix, when non-empty, is appended verbatim (after one blank
	// line) to the END of the fully composed system prompt — built-in and
	// disk-composed paths alike. It is the seam a swarm uses to attach its
	// team protocol to a persona whose prompt is assembled internally and so
	// cannot be pre-concatenated into a body string (RP-29). Living on the
	// definition (not an agent option) means every prompt re-render —
	// ReloadSkills, MCP discovery, SwitchProfile — re-reads it from the
	// registry and keeps it.
	PromptSuffix string
}

type DeferredToolSpec struct {
	Name string
}

type PromptContext struct {
	// Identity
	AgentName string    // e.g. "evva" — the name the main agent introduces itself as.
	Today     time.Time // anchors the model in absolute time; zero = use time.Now() at render.

	// OmitDate drops the "- Today:" line from the environment section. Long-
	// running personas (swarm members) set it so the system-prompt prefix stays
	// bit-stable across rebuilds — a drifting date would bust the prompt cache for
	// a swarm that runs for weeks. The time they need arrives in wake/run prompts,
	// never in the static system prompt (RP-5). Driven by AgentDefinition.LongRunning.
	OmitDate bool

	// OmitSkillAuthoring drops the "How to create a skill" guidance from the
	// main prompt's skills section. Long-running swarm-resident personas set
	// it (via AgentDefinition.LongRunning) for the same reason disk swarm
	// members do (RP-10-3): a member with write/bash should not be invited to
	// author SKILL.md mid-run.
	OmitSkillAuthoring bool

	// Environment
	OS       string // runtime.GOOS — "darwin", "linux", "windows".
	Shell    string // basename of $SHELL — "zsh", "bash", ...
	WorkDir  string // absolute path of the current working directory.
	EvvaHome string // ~/.evva — where skills, memory, and config live.
	Env      string // "dev" | "prod" — dev gates the feedback section.
	Model    string // canonical model id ("claude-opus-4-8", "deepseek-chat", ...). Empty = skip the model line in env block.

	// Catalogs
	Skills        []SkillRef         // advertised skill list; empty = skip the section.
	DeferredTools []DeferredToolSpec // deferred-tool catalog; rendered as a <functions> block in the main prompt. Empty = skip the section.

	// Memory (loaded by internal/memdir)
	WorkdirMemory string // contents of <workdir>/EVVA.md (user-authored); "" = skip.
	MemoryIndex   string // <appHome>/memory/MEMORY.md body (truncated, inject-ready); "" = skip.

	// EnableAutoMemory gates the typed-memory guidance + the MEMORY.md index
	// sections in the main prompt. false → both sections are suppressed so the
	// model isn't told about a memory system it can't use this session.
	EnableAutoMemory bool

	// EnableDynamicWorkflow swaps the multi-step-work protocol: true renders
	// the dynamic-workflow board guidance (wf_task_* + engine dispatch) in
	// place of the todo_write protocol, matching the tool swap the Main
	// profile performs under the same flag. Solo main agent only.
	EnableDynamicWorkflow bool

	// RepoMap is the already-rendered, token-bounded repo-map body (built by
	// internal/repomap from the LSP layer, or its glob fallback). "" → the
	// section is skipped entirely. The string arrives pre-rendered so this
	// package keeps its stdlib-only, no-IO discipline — the same one-way arrow
	// as memory. Main agent only; subagents never set it.
	RepoMap string

	// Output style (resolved by the caller via internal/outputstyle — same
	// one-way arrow as memory and skills). Empty OutputStylePrompt = the
	// default style: no overlay section, prompt byte-identical to a build
	// that never knew the feature. When set, the identity line defers to the
	// style ("according to your Output Style below…", ref's
	// getSimpleIntroSection) and an "# Output Style: <name>" section renders.
	// OutputStyleKeepCoding false additionally drops the "Doing tasks"
	// coding-doctrine section (ref's keepCodingInstructions === true check).
	// Main-tier agents only; subagents and swarm-resident (LongRunning)
	// personas never set these.
	OutputStyleName       string
	OutputStylePrompt     string
	OutputStyleKeepCoding bool
}

type SkillRef struct {
	Name        string
	Description string
}