memory

type ArtifactResolver interface {
	Get(context.Context, artifact.Snapshot) (artifact.Snapshot, error)
}

type Backend interface {
	Capabilities() Capabilities
	Get(context.Context, artifact.Ref) (Memory, error)
	Latest(context.Context, string) (Memory, error)
	Entries(context.Context, artifact.Ref) ([]EntryVersion, error)
	Projections(context.Context, artifact.Ref) ([]Projection, error)
	Commit(context.Context, Commit) (Memory, error)
	Changes(context.Context, artifact.Ref, *int64) ([]RevisionChanges, error)
	VectorComplete(context.Context, []artifact.Ref, EmbeddingProfile) (bool, error)
	Search(context.Context, SearchRequest) (SearchChannels, error)
	Expand(context.Context, []Hit) ([]EntryVersion, error)
}

type BackendConfigurationError struct{ Detail string }

type CandidatePipeline interface {
	Extract(context.Context, CandidateRequest) ([]EntryInput, error)
}

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

type CanonicalError struct {
	Code   string
	Detail any
}

type Capabilities struct {
	FTS              bool
	Vector           bool
	Hybrid           bool
	EmbeddingProfile *EmbeddingProfile
}

type CapabilityNotSupportedError struct {
	Capability string
	Detail     string
}

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

type ChangeOp string

type ChannelHit struct {
	MemoryRef      artifact.Ref
	EntryID        string
	EntryVersionID string
	Text           string
	Distance       *float64
}

type Citation struct {
	MemoryRef      artifact.Ref
	EntryID        string
	EntryVersionID string
}

type Clock func() time.Time

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

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

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

type DefaultEvidenceProjector struct{}

type Draft = artifact.Draft[Content]

type EmbeddingProfile struct {
	ProfileID     string
	Model         string
	Dimension     int
	Distance      string
	Normalization string
}

type EntryInactiveError struct{ EntryID string }

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

type EntryNotFoundError struct{ EntryID string }

type EntryState string

type EntryVersion struct {
	MemoryArtifactID  string
	EntryID           string
	EntryVersionID    string
	Version           int64
	PreviousVersionID *string
	Kind              string
	Text              string
	EntryContentHash  string
	CreatedInRevision int64
	Sources           []source.Ref
	Artifacts         []artifact.Ref
}

type EvidenceProjectionError struct{ Kind string }

type EvidenceProjector interface {
	ProjectSource(source.Value) (any, error)
	ProjectArtifact(artifact.Snapshot) (any, error)
}

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

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

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

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

type ExtractionIntent string

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

type ExtractionProfile string

type Hit struct {
	MemoryRef      artifact.Ref
	EntryID        string
	EntryVersionID string
	Text           string
	Score          float64
	MatchedBy      []MatchedBy
}

type IDFactory func(string) (string, error)

type InvalidCandidateError struct {
	Code   string
	Detail string
}

type InvalidCitationError struct{ Code string }

type InvalidEmbeddingError struct{ Code string }

type InvalidEvidenceError struct{ Code string }

type InvalidOperationError struct{ Code string }

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

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

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

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

type MatchedBy string

type Memory = artifact.Artifact[Content]

type OrganizeMode string

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

type RememberMode string

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

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

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

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

type RerankTrace struct {
	PolicyID           string
	CandidateHits      []Hit
	SelectedRanks      []int
	DiscardedRankCount int
	UsedFallback       bool
	LatencyMS          float64
	Usage              inference.Usage
}

type Reranker interface {
	PolicyID() string
	Rerank(context.Context, string, []Hit, int) (RerankDecision, error)
}

type RevisionChanges struct {
	MemoryRef artifact.Ref
	Changes   []Change
}

type SearchChannels struct {
	FTS    []ChannelHit
	Vector []ChannelHit
}

type SearchMode string

type SearchRequest struct {
	Query            string
	AnalyzedQuery    string
	Memories         []artifact.Ref
	CandidateLimit   int
	Mode             SearchMode
	QueryVector      []float64
	EmbeddingProfile *EmbeddingProfile
}

type SearchResult struct {
	Mode   SearchMode
	Hits   []Hit
	Rerank *RerankTrace
}

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

type ServiceOptions struct {
	CandidatePipeline    CandidatePipeline
	EmbeddingModel       inference.EmbeddingModel
	Reranker             Reranker
	RerankCandidateLimit int
	SourceResolver       SourceResolver
	ArtifactResolver     ArtifactResolver
	IDFactory            IDFactory
	Clock                Clock
}

type SourceResolver interface {
	Get(context.Context, source.Value) (source.Value, error)
	Ref(source.Value) (source.Ref, error)
}

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