harness

type CompactionPlan struct {
	// FirstKeptID is the entry where retained history starts.
	FirstKeptID string
	// ToSummarize is the history being folded into the summary.
	ToSummarize ai.Messages
	// TurnPrefix holds the leading messages of a split turn, summarized
	// separately (see SplitTurn).
	TurnPrefix ai.Messages
	// SplitTurn reports that the cut lands inside a turn: its prefix is
	// summarized while its tail is retained.
	SplitTurn bool
	// TokensBefore is the estimated context size before compaction.
	TokensBefore int
	// Previous is the prior compaction's summary, updated iteratively.
	Previous string
}

type CompactionSettings struct {
	// ContextTokens is the total context budget compaction defends.
	ContextTokens int
	// ReserveTokens is kept free for the summarization prompt and the next
	// turn's output (default [DefaultCompactionReserveTokens]).
	ReserveTokens int
	// KeepRecentTokens is approximately how much recent history survives a
	// compaction (default [DefaultCompactionKeepRecentTokens]).
	KeepRecentTokens int
	// SummaryTokens is the maximum output budget for the generated summary
	// (default [DefaultCompactionSummaryTokens]). It is deliberately distinct
	// from ReserveTokens, which protects the following normal model request.
	SummaryTokens int
}

type Context struct {
	// Messages is the conversation to send, oldest first.
	Messages ai.Messages
	// Provider and ModelID identify the model the branch last ran with (from
	// model_change entries and assistant responses); empty when unknown.
	Provider ai.Provider
	ModelID  string
}

type ContinuationPrompt func(context.Context, continuation.WorkRequest) ([]ai.Message, error)

type ContinuationResultMapper func(
	context.Context,
	continuation.WorkRequest,
	*agent.RunResult,
	string,
	string,
) (ai.JSON, error)

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

type ContinuationWorkerOption func(*continuationWorkerConfig) error

type Entry struct {
	Kind     Kind
	ID       string
	ParentID string
	Time     time.Time

	// Message and Usage are set on message entries. Usage is recorded for
	// assistant messages when the harness knows the turn's accounting.
	Message ai.Message
	Usage   *ai.Usage

	// Provider and ModelID are set on model_change entries.
	Provider ai.Provider
	ModelID  string

	// Summary is set on compaction and branch_summary entries; FirstKeptID
	// and TokensBefore on compaction; FromID on branch_summary.
	Summary      string
	FirstKeptID  string
	TokensBefore int
	FromID       string

	// Custom names the application entry type and Data carries its payload.
	Custom string
	Data   ai.JSON

	// TargetID and Label are set on label entries.
	TargetID string
	Label    string

	// Name is set on name entries.
	Name string

	// LeafID is set on leaf entries.
	LeafID string
}

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

type JSONLPrefix struct {
	Metadata  SessionMetadata
	Entries   []Entry
	Truncated bool
}

type JSONLPrefixLimits struct {
	MaxBytes   int
	MaxEntries int
}

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

type Kind string

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

type Option func(*hconfig)

type Phase string

type PromptTemplate struct {
	// Name is the stable identifier for lookup.
	Name string
	// Description is optional documentation.
	Description string
	// Content is the template text; see [PromptTemplate.Format].
	Content string
}

type Repo struct {
	// Dir is the directory holding the session files.
	Dir string
}

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

type SessionMetadata struct {
	// ID uniquely identifies the session.
	ID string `json:"id"`
	// CreatedAt is when the session was created.
	CreatedAt time.Time `json:"created_at"`
	// Path locates the backing file for file-based stores; empty otherwise.
	Path string `json:"path,omitempty"`
	// Extra carries application metadata recorded at creation.
	Extra map[string]string `json:"extra,omitempty"`
}

type Skill struct {
	// Name is the stable identifier listed to the model.
	Name string
	// Description tells the model when the skill applies.
	Description string
	// Content is the full instruction text.
	Content string
	// Source records application-owned provenance. Skill discovery and the
	// activation Tool never expose it to the model.
	Source string
	// License is the optional skill license declaration.
	License string
	// Compatibility records optional host or environment requirements.
	Compatibility string
	// Metadata is the optional scalar metadata mapping from the manifest.
	Metadata map[string]string
	// AllowedTools is declarative metadata only. A host must still enforce its
	// own Tool policy; this package never grants execution from a Skill.
	AllowedTools []string
	// Invocation controls user and model discovery. Its zero value allows both.
	Invocation SkillInvocation
	// Resources contains immutable application-validated sibling resources.
	Resources []SkillResource
}

type SkillActivation struct {
	Skill       Skill
	ActivatedAt time.Time
}

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

type SkillDiagnostic struct {
	Code    string
	Field   string
	Message string
}

type SkillInvocation uint8

type SkillResource struct {
	Path    string
	Size    int64
	Text    bool
	Content string
}

type Store interface {
	// Metadata identifies the stored session.
	Metadata() SessionMetadata
	// Append persists one entry.
	Append(e Entry) error
	// Entries returns all entries in append order.
	Entries() ([]Entry, error)
}

type SystemContext struct {
	// Model serves the upcoming run.
	Model ai.LanguageModel
	// Skills and Templates are the harness's configured resources.
	Skills    []Skill
	Templates []PromptTemplate
	// Session is the conversation being continued.
	Session *Session
}

type TreeLimits struct {
	MaxNodes int
	MaxDepth int
}

type TreeNode struct {
	ID           string
	ParentID     string
	Kind         Kind
	CreatedAt    time.Time
	Depth        int
	Label        string
	Current      bool
	OnActivePath bool
	HasSummary   bool
	Compacted    bool
}

type TreeSnapshot struct {
	SessionID  string
	Name       string
	LeafID     string
	Nodes      []TreeNode
	TotalNodes int
	MaxDepth   int
	Truncated  bool
}