contextview

type BudgetEnvelope struct {
	MaxTokens int
	// Plan activates unified provider-envelope budgeting. Nil preserves the
	// legacy unbudgeted provider selection path. Either Plan or
	// EnforceProtectedBudget makes the budget a provider allowance, which
	// charges fragments at least the provider envelope estimate.
	Plan *contextfrag.ContextBudgetPlan
	// EnforceProtectedBudget makes MaxTokens a hard allowance that includes
	// must-keep fragments without reactivating the turn-start system pass.
	// Step reselection uses it to fail closed when newly injected protected
	// context cannot fit the remaining provider envelope.
	EnforceProtectedBudget bool
	// RecentProtectTokens bands the newest droppable history within this many
	// charged tokens to drop last. Zero disables the window.
	RecentProtectTokens int
	ToolExchange        *contextfrag.ToolExchangePolicy
}

type BuildInput struct {
	Scope           contextfrag.Scope
	Intent          contextfrag.Intent
	Sources         []SourceSpec
	Targets         []contextfrag.RenderTarget
	Budget          BudgetEnvelope
	DynamicMutators []contextfrag.DynamicMutator
	Options         BuildOptions
	// Mutations is the run's live mutation ledger; renderers record
	// post-selection changes such as a final render prune onto it.
	Mutations *contextfrag.MutationLedger
}

type BuildOptions struct {
	DryRun bool
}

type BuildTrace struct {
	CollectDurations map[string]int64
	SelectionSummary SelectionSummary
	PlacementSummary PlacementSummary
	RenderSummaries  map[contextfrag.RenderTarget]RenderSummary
	Warnings         []contextfrag.ValidationWarning
}

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

type CollectRequest struct {
	Scope  contextfrag.Scope
	Intent contextfrag.Intent
	Config any
}

type Collector interface {
	Name() string
	Collect(context.Context, CollectRequest) ([]contextfrag.ContextFrag, error)
}

type CollectorRegistry interface {
	Get(name string) (Collector, bool)
	Names() []string
}

type ContextView struct {
	Intent      contextfrag.Intent
	SourceFrags []contextfrag.ContextFrag
	Selected    []contextfrag.ContextFrag
	Placement   PlacementPlan
	Manifest    contextfrag.Manifest
	Rendered    map[contextfrag.RenderTarget]RenderedPayload
	Trace       BuildTrace
}

type CurrentUserCollector struct{}

type CurrentUserConfig struct {
	Query string
}

type DiscussContextCollector struct{}

type DiscussContextConfig struct {
	// ComposedMessages is the authoritative output of timeline composition
	// when non-nil.
	ComposedMessages []timeline.ContextMessage
	// InlineImages are freshly surfaced attachments delivered as native vision
	// input on the latest user message.
	InlineImages []sdk.ImagePart
}

type DiscussContextInput struct {
	ComposedMessages []timeline.ContextMessage
	InlineImages     []sdk.ImagePart
	SystemFrags      []contextfrag.ContextFrag
}

type DiscussSDKContextBuilder struct{}

type DropRecord struct {
	FragID string
	Ref    contextfrag.ContextRef
	Reason string
}

type FragmentSelector struct{}

type HistoryMessagesCollector struct{}

type HistoryMessagesConfig struct {
	Messages []sdk.Message
	// CurrentUserMessageIndex identifies a current request already carried in
	// Messages. The history collector omits it and the current-user collector
	// retains it in the current-user slot.
	CurrentUserMessageIndex *int
	// MemoryMessageIndex identifies materialized memory recall that must be
	// collected separately without changing its provider message position.
	MemoryMessageIndex *int
	// TokenEstimates carries per-message token estimates computed at the
	// source. Missing entries fall back to fragment-side estimation.
	TokenEstimates []int
	// TrimmablePrefix marks the leading message count that may be dropped.
	// Messages at or after the boundary are protected.
	TrimmablePrefix int
	// RepairToolClosures applies the shared repair when a caller has not
	// already repaired its materialized message stream.
	RepairToolClosures bool
}

type HookContextCollector struct{}

type HookContextConfig struct {
	// Text is the combined resolver-hook AppendContext text materialized by
	// the application. The collector owns its role, placement, and cap.
	Text string
}

type IdentityPlacer struct{}

type InlineImageCollector struct{}

type InlineImageConfig struct {
	Images []sdk.ImagePart
}

type IntentProfile struct {
	Intent        contextfrag.Intent
	MustKeepSlots []contextfrag.Slot
	// MustKeepFrag evaluates retention that depends on fragment policy rather
	// than provider placement alone.
	MustKeepFrag func(contextfrag.ContextFrag) bool
	// SlotTrustFloors declares the minimum trust level per slot.
	SlotTrustFloors map[contextfrag.Slot]contextfrag.TrustLevel
}

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

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

type MemoryContextCollector struct{}

type MemoryContextConfig struct {
	Text    string
	Message *sdk.Message
	Index   int
}

type NoopRenderer struct {
	TargetName contextfrag.RenderTarget
}

type PassthroughSelector struct{}

type PlacementItem struct {
	FragID    string
	Slot      contextfrag.Slot
	Position  int
	CacheHint contextfrag.CacheClass
	Ref       contextfrag.ContextRef
}

type PlacementPlan struct {
	StablePrefixHash   string
	FirstVolatileIndex int
	Items              []PlacementItem
}

type PlacementSummary struct {
	StablePrefixFrags int
	DynamicFrags      int
}

type Placer interface {
	Place([]contextfrag.ContextFrag, contextfrag.Intent) PlacementPlan
}

type RenderInput struct {
	Intent    contextfrag.Intent
	Selected  []contextfrag.ContextFrag
	Placement PlacementPlan
	Manifest  *contextfrag.Manifest
	Scope     contextfrag.Scope
	Target    contextfrag.RenderTarget
}

type RenderSummary struct {
	Target      contextfrag.RenderTarget
	ContentHash string
	ItemCount   int
}

type RenderedPayload struct {
	Target      contextfrag.RenderTarget
	ContentHash string
	Data        any
}

type Renderer interface {
	Target() contextfrag.RenderTarget
	Render(context.Context, RenderInput) (RenderedPayload, error)
}

type RendererRegistry interface {
	Get(contextfrag.RenderTarget) (Renderer, bool)
}

type RuntimeFullContextRenderer struct {
	Config RuntimeRenderConfig
}

type RuntimeRenderConfig struct {
	Mode            RuntimeRenderMode
	ContextMarkdown string
	ContextURI      string
}

type RuntimeRenderMode string

type RuntimeRenderedPayload struct {
	ContextMarkdown string
	ContextURI      string
	ContentHash     string
}

type RuntimeSection struct {
	ID         string
	Text       string
	Kind       contextfrag.Kind
	Trust      contextfrag.TrustLevel
	Priority   int
	CacheClass contextfrag.CacheClass
	Budget     contextfrag.BudgetPolicy
}

type RuntimeSectionsCollector struct{}

type RuntimeSectionsConfig struct {
	Sections []RuntimeSection
}

type SDKMessagesRenderer struct{}

type SDKRenderedPayload struct {
	System       string
	Messages     []sdk.Message
	Query        string
	InlineImages []sdk.ImagePart
}

type SelectionResult struct {
	Selected []contextfrag.ContextFrag
	Dropped  []contextfrag.ContextFrag
	// FatalError stops rendering while allowing Builder to return the partial,
	// content-light selection audit accumulated before the failure.
	FatalError error
	// TrimNotice reports that budget trimming dropped history and the builder
	// must splice the trim notice into Selected at TrimNoticeIndex.
	TrimNotice      bool
	TrimNoticeIndex int
	Edited          []contextfrag.ContextEditTrace
	// EditReasons maps an edited fragment ID to its stable selection reason.
	EditReasons map[string]string
	Warnings    []contextfrag.ValidationWarning
	Summary     SelectionSummary
}

type SelectionSummary struct {
	TotalCollected int
	TotalSelected  int
	TotalDropped   int
	DropReasons    []DropRecord
}

type SelectionTag string

type Selector interface {
	ProfileFor(contextfrag.Intent) IntentProfile
	Select([]contextfrag.ContextFrag, IntentProfile, BudgetEnvelope) SelectionResult
}

type SourceSpec struct {
	Name   string
	Config any
}

type StablePrefixPlacer struct{}

type StaticCollector struct {
	CollectorName string
	Frags         []contextfrag.ContextFrag
}

type SystemPromptCollector struct{}

type SystemPromptConfig struct {
	System    string
	ToolUsage string
	// SplitWorkspace splits the workspace instruction section into its own
	// fragment even without embedded tool usage, so an agent-side tool usage
	// fragment can sort between prompt and workspace instructions.
	SplitWorkspace bool
}

type TaggedFrag struct {
	Frag contextfrag.ContextFrag
	Tags []SelectionTag
	// Tokens is the cost budget arithmetic charges for Frag. A hard provider
	// budget prices it with the envelope estimator so selection and the
	// rendered-envelope check agree; the fragment's own estimate is left
	// untouched so selection decisions do not read as trims.
	Tokens int
}