memory

type ContextItem struct {
	ID           string                 `json:"id"`
	EdgeType     string                 `json:"edge_type"`
	Confidence   string                 `json:"confidence"`
	Frontmatter  map[string]interface{} `json:"frontmatter"`
	BodyIncluded bool                   `json:"body_included"`
	// BodyExcerpted marks Body as the note's most decision-relevant passage
	// rather than its whole text. It is recorded rather than inferred because
	// "the agent got the note" and "the agent got the gist" are different facts,
	// and a metric that cannot tell them apart reports the second as the first.
	BodyExcerpted bool   `json:"body_excerpted,omitempty"`
	Body          string `json:"body,omitempty"`
}

type ContextPackConfig struct {
	Input            string
	Budget           int                // token budget
	Depth            int                // BFS traversal depth; 0 or 1 = direct neighbors only (default)
	MaxItems         int                // max context items to return; 0 = unlimited (default, backward-compat)
	Slim             bool               // reduce context item frontmatter to {type, title, status} only
	ActivationScores map[string]float64 // optional activation scores keyed by note ID

	// ExcerptTokens caps a per-item excerpt used when a whole body will not fit
	// the remaining budget. 0 (default) keeps the released all-or-nothing
	// behaviour, where such an item contributes no text at all.
	//
	// Without this, a pack can honestly report "3 items" while handing the agent
	// nothing but titles — which is what a 900-token hook budget does against a
	// vault whose median note is larger than the budget.
	ExcerptTokens int
}

type ContextPackResult struct {
	TargetID        string             `json:"target_id"`
	BudgetTokens    int                `json:"budget_tokens"`
	UsedTokens      int                `json:"used_tokens"`
	BudgetExhausted bool               `json:"budget_exhausted"`
	Truncated       bool               `json:"truncated"`
	Target          *ContextPackTarget `json:"target"`
	Context         []ContextItem      `json:"context"`
}

type ContextPackTarget struct {
	ID          string                 `json:"id"`
	Frontmatter map[string]interface{} `json:"frontmatter"`
	// BodyExcerpted marks Body as the note's decision-bearing passage rather
	// than its whole text — same meaning as on ContextItem, and needed here for
	// the same reason: a renderer that cannot tell the difference will truncate
	// an already-bounded excerpt a second time.
	BodyExcerpted bool   `json:"body_excerpted,omitempty"`
	Body          string `json:"body,omitempty"`
}

type RecallConfig struct {
	Input         string
	Depth         int
	MinConfidence string
	MaxNodes      int
}

type RecallEdge struct {
	SourceID   string `json:"source_id"`
	TargetID   string `json:"target_id"`
	EdgeType   string `json:"edge_type"`
	Confidence string `json:"confidence"`
}

type RecallNode struct {
	ID             string                 `json:"id"`
	Type           string                 `json:"type"`
	Title          string                 `json:"title"`
	Distance       int                    `json:"distance"`
	EdgeFromParent *graph.TraverseEdge    `json:"edge_from_parent,omitempty"`
	Frontmatter    map[string]interface{} `json:"frontmatter"`
}

type RecallResult struct {
	TargetID        string       `json:"target_id"`
	Depth           int          `json:"depth"`
	MaxNodes        int          `json:"max_nodes"`
	MaxNodesReached bool         `json:"max_nodes_reached"`
	Nodes           []RecallNode `json:"nodes"`
	Edges           []RecallEdge `json:"edges"`
}

type ReciteConfig struct {
	// Type is the note type to enumerate ("arc").
	Type string
	// Budget is the total token ceiling. 0 means unbounded.
	Budget int
	// ExcerptTokens caps each note's contribution. 0 means whole bodies.
	ExcerptTokens int
}

type ReciteItem struct {
	ID      string `json:"id"`
	Title   string `json:"title"`
	Excerpt string `json:"excerpt"`
	Tokens  int    `json:"tokens"`
}

type ReciteResult struct {
	Type       string       `json:"type"`
	Total      int          `json:"total"`
	Items      []ReciteItem `json:"items"`
	Omitted    int          `json:"omitted"`
	OmittedIDs []string     `json:"omitted_ids,omitempty"`
	Tokens     int          `json:"tokens"`
	Budget     int          `json:"budget"`
}

type RelatedConfig struct {
	Input string
	Mode  string // "mixed", "explicit", or "inferred"
}

type RelatedItem struct {
	ID         string  `json:"id"`
	Type       string  `json:"type"`
	Title      string  `json:"title"`
	EdgeType   string  `json:"edge_type"`
	Confidence string  `json:"confidence"`
	Origin     string  `json:"origin"`
	Score      float64 `json:"score,omitempty"`
}

type RelatedResult struct {
	TargetID string        `json:"target_id"`
	Mode     string        `json:"mode"`
	Related  []RelatedItem `json:"related"`
}

type SummarizeConfig struct {
	NoteIDs     []string
	IncludeBody bool
	MaxBodyLen  int // max chars per note body (0 = full)
}

type SummarizeResult struct {
	Sources   []SummarizeSource `json:"sources"`
	NoteCount int               `json:"note_count"`
	NotFound  []string          `json:"not_found,omitempty"`
}

type SummarizeSource struct {
	ID          string                 `json:"id"`
	Type        string                 `json:"type"`
	Title       string                 `json:"title"`
	Frontmatter map[string]interface{} `json:"frontmatter"`
	BodyExcerpt string                 `json:"body_excerpt,omitempty"`
}