Skip to main content

internal/recall/surfaces.go

internal/recall · 64 lines · 7 declarations · source

Declarations​

type Semantic​

type Semantic interface {
	// EntityAnchors proposes entities the question means, by similarity over stored names and
	// evidence. A proposal becomes an anchor to walk from and never a merged identity.
	EntityAnchors(ctx context.Context, scope, question string, limit int) ([]domain.Anchor, error)
	// Reports returns the community reports nearest the question, each followed by up to
	// `children` of the best match's children from the stored hierarchy, with their sources.
	Reports(ctx context.Context, scope, question string, limit, children int) ([]domain.ReportHit, error)
	// Passages returns source messages nearest the question, restricted to the given roles.
	// Passages is narrowed to one person when subject is not empty: a passage is somebody's words,
	// and a recall narrowed to one person must not quote anybody else.
	Passages(ctx context.Context, scope, question string, limit int, roles []string, subject string) ([]domain.Passage, error)
}

Semantic is what recall may consult after exact anchoring. Every method is bounded by the caller, scoped to one project, and free to refuse: a surface that refuses is reported as degraded and the rest of the bundle still answers. There is deliberately no generation here; the only model work any of these may do is embed the question, which D106 already opted the read path into.

source

const SurfaceFacts, SurfaceReports, SurfacePassages and 4 more​

const (
	SurfaceFacts    = "facts"
	SurfaceReports  = "reports"
	SurfacePassages = "passages"

	MaxSemanticAnchors = 4
	MaxReportHits      = 3
	MaxReportChildren  = 5
	MaxPassageHits     = 8
)

The surfaces a caller may select, and the bounds each runs under. The bounds are per call and small on purpose: a surface exists to start a walk or to fill what the budget has left, not to replace the anchor-bounded read G1 is about.

source

var AllSurfaces​

var AllSurfaces = []string{SurfaceFacts, SurfaceReports, SurfacePassages}

AllSurfaces is what a caller gets by naming none.

source

method Recaller.WithSemantic​

func (r *Recaller) WithSemantic(s Semantic) *Recaller

WithSemantic returns a recaller that composes the given surfaces. Nil keeps the exact path alone, which is what a deployment without an embedding revision runs.

source

func reportSize​

func reportSize(h domain.ReportHit) int

source

func passageSize​

func passageSize(p domain.Passage) int

source

func validSurface​

func validSurface(s string) bool

source