memorypipe

type Drop struct {
	ID   string
	Why  string
	Text string // 摘要（截断），便于宿主排查
}

type Entry struct {
	// ID 稳定标识（渲染时进标记，模型据此引用）。
	ID string
	// Text 正文。
	Text string
	// Scope 作用域（宿主自定词表；本包只做**精确匹配**）。
	Scope string
	// Tags 标签（查询按 AND 匹配）。
	Tags []string
	// Source 来源（**必填**：没有来源的条目与猜测不可分）。
	Source string
	// At 产生时刻（渲染进标记，供模型判新鲜度）。
	At time.Time
}

type Piece struct {
	Entry Entry
	Text  string // 可能被字节裁剪过的正文
}

type Query struct {
	// Scope 只要这个作用域的条目。
	Scope string
	// Tags 必须全部命中（AND；OR 会让「加个标签」变成放宽而不是收紧）。
	Tags []string
	// MaxItems 最多注入几条（<=0 = 不限制）。
	MaxItems int
	// MaxBytes 正文总字节上限（<=0 = 不限制）。
	MaxBytes int
}

type Result struct {
	Pieces    []Piece
	Dropped   []Drop
	Truncated bool
	Reason    string
}