contextpack

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

type AttachmentPreparer interface {
	PrepareAttachments(ctx context.Context, messages []protocol.ChatMessage) ([]sysprompt.AttachmentSummary, error)
}

type Config struct {
	MaxHistoryMessages int
	MaxTextPartBytes   int
	// MaxContextTokens, when > 0, caps the estimated tokens of the assembled
	// context (system prompt + history). History is trimmed to fit the budget
	// remaining after the system prompt. 0 disables token budgeting (count/byte
	// caps still apply, plus the turn loop's reactive overflow recovery).
	MaxContextTokens int

	// Compactor, when set, is the pluggable strategy used to fit history to the
	// per-call budget (evict/summarize/classic composites). nil -> the historical
	// ReduceWithReport drop-oldest behavior, byte-for-byte unchanged.
	Compactor compaction.Compactor

	// InvokedSkillTTL bounds how many turns a load_skill invocation stays listed
	// in the "## Loaded skills" prompt section. 0 -> defaultInvokedSkillTTL.
	InvokedSkillTTL int

	// AttachmentPreparer, when set, materializes the current turn's non-image
	// attachments and returns their summaries for the "## Attached documents/files"
	// prompt sections. nil -> no attachment section (today's behavior).
	AttachmentPreparer AttachmentPreparer

	// PromptNotes is the selected authoritative source of reusable workspace
	// instructions. nil disables the section. Provider and validation failures
	// fail prompt assembly rather than silently dropping or cross-falling back.
	PromptNotes promptnotes.WorkspaceProvider

	// SkillRelevance, when set, ranks/selects the skills listed each turn and may
	// nominate skills to auto-realize (inject their body). nil -> the full Skills
	// catalog is listed in the cacheable prefix and nothing is auto-realized.
	SkillRelevance SkillRelevanceProvider
	// SkillBodies resolves a skill's body for auto-realization. nil -> auto-realize
	// is disabled even when a provider nominates skills. Typically the skill registry.
	SkillBodies SkillBodyResolver
	// AutoRealizeStaleTurns: a nominated skill already loaded via load_skill within
	// this many turns is considered still in-context and is NOT re-injected (dedup).
	// 0 -> defaultAutoRealizeStaleTurns.
	AutoRealizeStaleTurns int
	// MaxAutoRealizeBytes caps the total body bytes injected by auto-realize per
	// turn. 0 -> defaultMaxAutoRealizeBytes.
	MaxAutoRealizeBytes int

	// System-prompt inputs (see internal/sysprompt).
	Base      string
	Tools     []sysprompt.ToolSummary
	Subagents bool // spawn_subagent available → emit delegation guidance
	// SkillLoadTool reports that the load_skill tool is registered, so the skills
	// listing instructs the model to load by name (not read_file the path).
	SkillLoadTool bool
	Skills        []sysprompt.SkillSummary
	// SkillLoadWarnings surfaces the untrusted skill-load warnings collected by
	// skills.DiscoverWithWarnings (malformed name, over-cap SKILL.md, dropped
	// duplicate). Rendered as an escaped, explicitly-untrusted prompt section.
	SkillLoadWarnings []string
	MemoryTools       bool
	MaxFileBytes      int
	WorkspaceDir      string
	Model             string
	SandboxID         string
	Now               func() time.Time
}

type RankedSkill struct {
	Name string
	Note string
}

type RealizedSkill struct {
	Name     string
	AgeTurns int
}

type SkillBodyResolver func(name string) (body string, ok bool)

type SkillCandidate struct {
	Name        string
	Description string
}

type SkillCatalog struct {
	Skills       []sysprompt.SkillSummary
	Bodies       SkillBodyResolver
	LoadWarnings []string
}

type SkillListMode int

type SkillRelevanceProvider interface {
	RankSkills(ctx context.Context, req SkillRelevanceRequest) (SkillRelevanceResult, error)
}

type SkillRelevanceRequest struct {
	// Available is the full catalog the model may use (listing metadata only).
	Available []SkillCandidate
	// History is the recent conversation the provider judges relevance against.
	History []protocol.ChatMessage
	// Realized names skills already loaded via load_skill this session, with age.
	Realized []RealizedSkill
	// Turn is the in-flight turn number (monotonic, survives compaction).
	Turn int
}

type SkillRelevanceResult struct {
	// Listed, when non-empty, is the relevance-ordered listing for the prompt's
	// skills section. Empty preserves the full catalog listing unchanged.
	Listed []RankedSkill
	// Mode decides how Listed interacts with the full catalog (refine vs replace).
	Mode SkillListMode
	// Realize names skills to inject (body) this turn. The assembler resolves each
	// body via the SkillBodyResolver, skips any that are already realized+fresh
	// (dedup) or unresolvable, and caps the total injected bytes — so a provider
	// may nominate freely.
	Realize []string
	// Suppressed counts catalog skills the provider omitted from Listed because they
	// are prerequisites of a shown skill (they auto-load with it). The assembler
	// excludes these from the "+N more available" hint — a covered prerequisite is
	// not a coverage gap. 0 when the provider does no prerequisite suppression.
	Suppressed int
}