sysprompt

type AttachmentSummary struct {
	Name    string
	Mime    string
	Size    int64
	Purpose string
	Path    string
	// Error, when non-empty, means the attachment could NOT be materialized
	// (fetch/permission failure). It is still listed — so the model knows an
	// input was provided but is missing rather than pursuing the task blind —
	// with this reason and no Path/usable bytes.
	Error string
}

type AutoLoadedSkill struct {
	Name string
	Body string
}

type Input struct {
	Base      string // base instructions; DefaultBase if empty
	Bootstrap []bootstrap.File
	Tools     []ToolSummary
	Skills    []SkillSummary
	// SkillsDynamic renders the "## Skills" listing in the dynamic suffix rather
	// than the cacheable prefix — set when a relevance provider makes the listing
	// per-turn. Off (default) keeps the full catalog in the stable, cacheable prefix.
	SkillsDynamic bool
	// SkillLoadTool reports that the load_skill tool is registered, so the "## Skills"
	// section instructs the model to load a skill by name (load_skill resolves the
	// file + prerequisites) instead of reading its file directly. Off -> the model is
	// told to read_file the skill path (the path is then listed per skill).
	SkillLoadTool bool
	// SkillsHidden is the count of catalog skills NOT shown in the listing because a
	// relevance provider capped it (ListReplace). >0 renders a "+N more available"
	// hint so the model knows the listing is a relevance-filtered subset, not the
	// whole catalog. 0 -> no hint.
	SkillsHidden     int
	AutoLoadedSkills []AutoLoadedSkill // bodies injected this turn by a relevance provider (dynamic)
	LoadedSkills     []LoadedSkill     // previously loaded via load_skill (dynamic; carries age)
	// SkillLoadWarnings are skill-discovery validation warnings (see
	// skills.DiscoverWithWarnings) — e.g. a malformed skill name or an over-cap
	// description. Derived from untrusted on-disk content, so each is
	// HTML-escaped and framed as non-instructional when rendered.
	SkillLoadWarnings []string
	RecentFiles       []RecentFile   // files written/edited this session (dynamic; carries age)
	Todos             []TodoLine     // the agent's todo board (dynamic; carries age)
	Subagents         []SubagentLine // sub-agents delegated to this session (dynamic; carries age)
	// Attachments are the non-image files attached to the current turn's user
	// message, materialized to disk and surfaced as a text listing (name/mime/size
	// + on-disk path) so the model can open them with its file tools. Images are
	// delivered inline (not listed here). Per-turn (dynamic); empty -> omitted.
	Attachments []AttachmentSummary
	// PromptNotes are authoritative reusable workspace instructions. They are
	// dynamic because the resolved workspace and current revisions can differ per
	// turn. The assembler validates and orders them before Build.
	PromptNotes []PromptNote
	// RequestInstructions are per-turn caller-supplied instructions (e.g. an
	// agent.synthesize one-shot's options.system/instructions), rendered as the
	// last, highest-salience suffix section. Authenticated request config; empty ->
	// omitted.
	RequestInstructions string
	MemoryTools         bool // emit the Memory guidance section (memory_search/memory_get available)
	SubagentsEnabled    bool // emit the delegation guidance section (spawn_subagent available)
	MaxFileBytes        int  // per-file cap for bootstrap content; 0 disables capping
	WorkspaceDir        string
	Model               string
	SandboxID           string
	Now                 time.Time // zero -> runtime line omits time
}

type LoadedSkill struct {
	Name     string
	AgeTurns int
}

type Prompt struct {
	StablePrefix  string // base + tools + project context (cacheable)
	DynamicSuffix string // runtime line (changes per turn)
}

type PromptNote struct {
	Key     string `json:"key"`
	Title   string `json:"title,omitempty"`
	Content string `json:"instructions"`
}

type RecentFile struct {
	Path     string
	Kind     string // write | edit
	AgeTurns int
}

type SkillSummary struct {
	Name        string
	Description string
	Path        string
	Note        string
}

type SubagentLine struct {
	Name     string
	ThreadID string
	Status   string
	Summary  string
	AgeTurns int
}

type TodoLine struct {
	Content  string
	Status   string
	AgeTurns int
}

type ToolSummary struct {
	Name        string
	Description string
}