memory

module
v0.1.2 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jun 1, 2026 License: MIT

Directories

Path Synopsis
Package history manages conversation transcripts: append messages, load them back fitted to a model's context window, and (optionally) compact older turns into hierarchical summaries to keep that window finite.
Package history manages conversation transcripts: append messages, load them back fitted to a model's context window, and (optionally) compact older turns into hierarchical summaries to keep that window finite.
internal
background
Package background provides memory-internal lifecycle primitives for long-lived background work.
Package background provides memory-internal lifecycle primitives for long-lived background work.
syncx
Package syncx provides synchronization primitives that round out the stdlib `sync` toolkit for memory-internal use.
Package syncx provides synchronization primitives that round out the stdlib `sync` toolkit for memory-internal use.
Package knowledge implements the layered knowledge base: document storage, chunking, tokenization, and BM25 / vector / hybrid retrieval over three context layers (L0 abstract, L1 overview, L2 chunk detail).
Package knowledge implements the layered knowledge base: document storage, chunking, tokenization, and BM25 / vector / hybrid retrieval over three context layers (L0 abstract, L1 overview, L2 chunk detail).
backend/fs
Package fs implements knowledge.DocumentRepo, knowledge.ChunkRepo and knowledge.LayerRepo on top of any workspace.Workspace.
Package fs implements knowledge.DocumentRepo, knowledge.ChunkRepo and knowledge.LayerRepo on top of any workspace.Workspace.
backend/retrieval
Package retrieval implements knowledge.ChunkRepo and knowledge.LayerRepo on top of any retrieval.Index.
Package retrieval implements knowledge.ChunkRepo and knowledge.LayerRepo on top of any retrieval.Index.
factory
Package factory wires the canonical knowledge.Service stacks.
Package factory wires the canonical knowledge.Service stacks.
Package recall is the v2 fact-centric long-term memory API.
Package recall is the v2 fact-centric long-term memory API.
diagnostics
Package diagnostics is the only public diagnostics surface for sdk/recall.
Package diagnostics is the only public diagnostics surface for sdk/recall.
internal/domain/diagnostic
Package diagnostic owns the v2 structured pipeline observation surface.
Package diagnostic owns the v2 structured pipeline observation surface.
internal/evolution
Package evolution hosts background memory maintenance hooks.
Package evolution hosts background memory maintenance hooks.
internal/fusion
Package fusion combines multi-source candidate lists into a single ranked candidate set.
Package fusion combines multi-source candidate lists into a single ranked candidate set.
internal/ingest
Package ingest owns the write-time ingestion pipeline.
Package ingest owns the write-time ingestion pipeline.
internal/lens/entity
Package entity implements the canonical entity mention projection.
Package entity implements the canonical entity mention projection.
internal/lens/graph
Package graph implements the optional EntityGraph projection (docs §8.4).
Package graph implements the optional EntityGraph projection (docs §8.4).
internal/lens/profile
Package profile implements the optional active-slot profile projection for state, preference, procedure, and relation facts (docs §8.3).
Package profile implements the optional active-slot profile projection for state, preference, procedure, and relation facts (docs §8.3).
internal/lens/relation
Package relation implements the optional typed-relation projection.
Package relation implements the optional typed-relation projection.
internal/lens/retrieval
Package retrieval implements the canonical retrieval projection.
Package retrieval implements the canonical retrieval projection.
internal/lens/semantic
Package semantic implements task-specific assertion projections used by reasoning-heavy recall paths.
Package semantic implements task-specific assertion projections used by reasoning-heavy recall paths.
internal/lens/timeline
Package timeline implements the optional timeline projection.
Package timeline implements the optional timeline projection.
internal/materialize
Package materialize turns fused candidates back into grounded ContextItems by looking up their canonical fact in the temporal store and attaching embedded evidence (docs §9.4).
Package materialize turns fused candidates back into grounded ContextItems by looking up their canonical fact in the temporal store and attaching embedded evidence (docs §9.4).
internal/pipeline
Package pipeline is the v2 recall stage-orchestration framework.
Package pipeline is the v2 recall stage-orchestration framework.
internal/pipeline/feedback
Package feedback owns the pipeline that applies caller feedback (Reinforce / Penalize) to a canonical fact.
Package feedback owns the pipeline that applies caller feedback (Reinforce / Penalize) to a canonical fact.
internal/pipeline/feedback/stages
Package stages owns the apply_feedback stage that powers Memory.Reinforce / Memory.Penalize.
Package stages owns the apply_feedback stage that powers Memory.Reinforce / Memory.Penalize.
internal/pipeline/forget
Package forget owns the scope-wide retirement pipeline for GDPR Art.17 / CCPA 1798.105 compliance.
Package forget owns the scope-wide retirement pipeline for GDPR Art.17 / CCPA 1798.105 compliance.
internal/pipeline/forget/stages
Package stages owns the single forget_all stage that powers Memory.ForgetAll.
Package stages owns the single forget_all stage that powers Memory.ForgetAll.
internal/pipeline/read
Package read owns the read-flow pipeline State and Runner.
Package read owns the read-flow pipeline State and Runner.
internal/pipeline/rebuild
Package rebuild owns the rebuild-flow pipeline State and Runner.
Package rebuild owns the rebuild-flow pipeline State and Runner.
internal/pipeline/revision
Package revision owns the pipeline that drives Memory.Fork and Memory.Contest.
Package revision owns the pipeline that drives Memory.Fork and Memory.Contest.
internal/pipeline/revision/stages
Package stages owns the three revision pipeline stages (lookup_source / attach_revision / revision_save).
Package stages owns the three revision pipeline stages (lookup_source / attach_revision / revision_save).
internal/pipeline/sideeffect
Package sideeffect executes commit-after outbox jobs outside the scope write lock.
Package sideeffect executes commit-after outbox jobs outside the scope write lock.
internal/pipeline/write
Package write owns the write-flow pipeline State and Runner.
Package write owns the write-flow pipeline State and Runner.
internal/pipeline/write/stages
Package stages assembles the write-flow pipeline's ordered Stage list.
Package stages assembles the write-flow pipeline's ordered Stage list.
internal/planner
Package planner turns a caller Query into a deterministic QueryPlan.
Package planner turns a caller Query into a deterministic QueryPlan.
internal/port
Package port declares the contractual interfaces every recall subsystem depends on.
Package port declares the contractual interfaces every recall subsystem depends on.
internal/store/asyncsemantic
Package asyncsemantic provides an in-memory AsyncSemanticQueue for tests and the SDK's default zero-config development experience.
Package asyncsemantic provides an in-memory AsyncSemanticQueue for tests and the SDK's default zero-config development experience.
internal/store/evidence
Package evidence is the secondary-lookup boundary for raw source material attached to canonical facts.
Package evidence is the secondary-lookup boundary for raw source material attached to canonical facts.
internal/store/sideeffect
Package sideeffect provides the in-memory SideEffectOutbox used by tests and the SDK default stack.
Package sideeffect provides the in-memory SideEffectOutbox used by tests and the SDK default stack.
ops
Package ops composes memory/recall's caller-driven processors into embeddable operator loops.
Package ops composes memory/recall's caller-driven processors into embeddable operator loops.
recalltest
Package recalltest contains reusable conformance suites for sdk/recall adapter implementations.
Package recalltest contains reusable conformance suites for sdk/recall adapter implementations.
store/postgres
Package postgres provides durable memory/recall stores backed by PostgreSQL.
Package postgres provides durable memory/recall stores backed by PostgreSQL.
store/sqlite
Package sqlite provides durable memory/recall stores backed by one SQLite database file.
Package sqlite provides durable memory/recall stores backed by one SQLite database file.
store/workspace
Package workspace provides durable memory/recall stores backed by an sdk/workspace.Workspace.
Package workspace provides durable memory/recall stores backed by an sdk/workspace.Workspace.
Package retrieval defines the unified indexing and retrieval API.
Package retrieval defines the unified indexing and retrieval API.
bbh
Package bbh implements a local retrieval.Index backed by Badger, Bleve, and coder/hnsw.
Package bbh implements a local retrieval.Index backed by Badger, Bleve, and coder/hnsw.
contract
Package contract provides a backend-agnostic test suite that any retrieval.Index implementation MUST pass.
Package contract provides a backend-agnostic test suite that any retrieval.Index implementation MUST pass.
journal
Package journal provides an optional append-only audit log over retrieval.Index.
Package journal provides an optional append-only audit log over retrieval.Index.
memory
Package memory provides MemoryIndex, the zero-dependency in-process retrieval.Index implementation.
Package memory provides MemoryIndex, the zero-dependency in-process retrieval.Index implementation.
namespace
Package namespace centralises retrieval namespace construction.
Package namespace centralises retrieval namespace construction.
pipeline
Package pipeline composes pluggable retrieval Stages over a retrieval.Index .
Package pipeline composes pluggable retrieval Stages over a retrieval.Index .
postgres
Package postgres provides a retrieval.Index backed by PostgreSQL with pg_trgm + tsvector + jsonb (and optional pgvector for vector lanes).
Package postgres provides a retrieval.Index backed by PostgreSQL with pg_trgm + tsvector + jsonb (and optional pgvector for vector lanes).
scoring
Package scoring exposes the small kernel of pure functions that retrieval backends and fusion stages share — vector similarity and rank-fusion algorithms — so they can be reused without reaching into a backend's package-private guts or constructing a pipeline stage just to invoke the algorithm.
Package scoring exposes the small kernel of pure functions that retrieval backends and fusion stages share — vector similarity and rank-fusion algorithms — so they can be reused without reaching into a backend's package-private guts or constructing a pipeline stage just to invoke the algorithm.
sqlite
Package sqlite provides a retrieval.Index backed by a single SQLite database file.
Package sqlite provides a retrieval.Index backed by a single SQLite database file.
workspace
Package workspace implements a retrieval.Index backed by any sdkworkspace.Workspace implementation (MemWorkspace, LocalWorkspace, ScopedWorkspace, or a future remote backend such as S3Workspace).
Package workspace implements a retrieval.Index backed by any sdkworkspace.Workspace implementation (MemWorkspace, LocalWorkspace, ScopedWorkspace, or a future remote backend such as S3Workspace).
text
bm25
Package bm25 implements Okapi BM25 scoring with a pluggable tokenizer.
Package bm25 implements Okapi BM25 scoring with a pluggable tokenizer.
lemma
Package lemma provides irregular-form lemmatisation for English.
Package lemma provides irregular-form lemmatisation for English.
normalize
Package normalize provides Unicode-aware string canonicalisation primitives used by the sdk/text family and any downstream component that needs schema-grade equality on free-form text columns.
Package normalize provides Unicode-aware string canonicalisation primitives used by the sdk/text family and any downstream component that needs schema-grade equality on free-form text columns.
phrase
Package phrase provides token-boundary phrase matching for higher-level text understanding code that should not hand-roll string scans.
Package phrase provides token-boundary phrase matching for higher-level text understanding code that should not hand-roll string scans.
quotes
Package quotes provides quote-span extraction over text that mixes ASCII, smart, and CJK quotation marks.
Package quotes provides quote-span extraction over text that mixes ASCII, smart, and CJK quotation marks.
stem
Package stem houses morphological stemmers for the sdk/text family.
Package stem houses morphological stemmers for the sdk/text family.
stem/adapter/snowball
Package snowball adapts github.com/kljensen/snowball to the sdk/text/stem function signature.
Package snowball adapts github.com/kljensen/snowball to the sdk/text/stem function signature.
stopword
Package stopword provides high-frequency-word filters used by the sdk/text tokenizers and any downstream component that needs to exclude semantically empty words from BM25 vocabularies, NER candidate lists, or query intent extraction.
Package stopword provides high-frequency-word filters used by the sdk/text tokenizers and any downstream component that needs to exclude semantically empty words from BM25 vocabularies, NER candidate lists, or query intent extraction.
timex
Package timex parses natural-language and absolute time expressions embedded inside free text.
Package timex parses natural-language and absolute time expressions embedded inside free text.
tokenize
Package tokenize provides tokenizers for the sdk/text family.
Package tokenize provides tokenizers for the sdk/text family.
tokenize/adapter/gse
Package gse adapts github.com/go-ego/gse to the sdk/text/tokenize.Tokenizer interface.
Package gse adapts github.com/go-ego/gse to the sdk/text/tokenize.Tokenizer interface.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL