api

type ActiveSkill struct {
	Name  string
	Scope string
	Args  map[string]string
}

type ErrorCode string

type InputPolicy interface {
	Evaluate(req PastePolicyInput, hasPathLikeContent bool) Result[PastePolicyDecision]
}

type PastePolicyDecision struct {
	ShouldCompress bool
	Reason         string
}

type PastePolicyInput struct {
	Input              string
	Source             string
	Workspace          string
	LastInputAt        time.Time
	LastPasteAt        time.Time
	InputBurstSize     int
	PasteSubmitGuard   time.Duration
	PasteBurstWindow   time.Duration
	PasteQuickChars    int
	BurstImmediateMin  int
	BurstCharThreshold int
	ContinuationWindow time.Duration
}

type PromptBuildRequest struct {
	RawInput        string
	MentionBindings map[string]llm.AssetID
	Pasted          any
}

type PromptBuildResult struct {
	Prompt      agent.RunPromptInput
	DisplayText string
}

type PromptBuilder interface {
	Build(req PromptBuildRequest, pasted tuiruntime.PastedState) Result[PromptBuildResult]
}

type Provider interface {
	BindSession(sess *session.Session)
	Skills() SkillsManager
	InputPolicy() InputPolicy
	PromptBuilder() PromptBuilder
}

type Result[T any] struct {
	Success bool
	Data    T
	Error   string
	Code    ErrorCode
}

type SkillActivation struct {
	Name       string
	Scope      string
	EntrySlash string
	ToolPolicy string
	Args       map[string]string
}

type SkillDeleteResult struct {
	Name          string
	Dir           string
	ClearedActive bool
}

type SkillDiagnostic struct {
	Level   string
	Skill   string
	Path    string
	Message string
}

type SkillItem struct {
	Name        string
	Scope       string
	Description string
	Slash       string
	Aliases     []string
	ToolPolicy  string
}

type SkillsManager interface {
	GetState() Result[SkillsState]
	Activate(name string, args map[string]string) Result[SkillActivation]
	Clear() Result[string]
	Delete(name string) Result[SkillDeleteResult]
}

type SkillsState struct {
	Active      *ActiveSkill
	Items       []SkillItem
	Diagnostics []SkillDiagnostic
}