Add the agent memory lifecycle: brain, holistic recall, pre/post-turn, belief builds - #194

Merged

senamakel merged 132 commits into

tinyhumansai:mainfrom

senamakel:agent-memory

Oct 4, 2026

Commits on Oct 4, 2026

fix(api): remove unused namespace module

senamakel
and
medullabot
committed
2ccc89c
fix(tinymemory-api): correct test assertion for namespace lookup

senamakel
and
medullabot
committed
9b505a4
fix(consolidate): handle empty write batch in consolidation

senamakel
and
medullabot
committed
1c94c56
test(consolidate): add tests for memory consolidation logic

senamakel
and
medullabot
committed
42a4079
feat(api): add store_with and consolidate to MemoryEngine

senamakel
and
medullabot
committed
757b6e9
feat(api): add consolidation field to engine descriptors

senamakel
and
medullabot
committed
e67577b
fix(conformance): update reference implementation to match engine behavior

senamakel
and
medullabot
committed
1728e29
chore(tinymemory-api): add mod_tests module for explore

senamakel
and
medullabot
committed
c7d29f1
fix(conformance): handle empty input in distil reference implementation

senamakel
and
medullabot
committed
cee37e9
fix(conformance): handle empty reference in distil

senamakel
and
medullabot
committed
408950b
fix(conformance): add missing module documentation

senamakel
and
medullabot
committed
b298ff5
fix(conformance): add lifecycle checks to conformance test suite

senamakel
and
medullabot
committed
8230354
chore(conformance): fix indentation in namespace test comment

senamakel
and
medullabot
committed
47981cc
feat(tests): add consolidation conformance tests

senamakel
and
medullabot
committed
84b6099
fix(engine): handle missing descriptor in store lookup

senamakel
and
medullabot
committed
833468b
fix(engine): handle empty scope in consolidation

senamakel
and
medullabot
committed
3e86a44
fix(consolidate): handle empty consolidation set gracefully

senamakel
and
medullabot
committed
c7db7b8
fix(cortex/testing): remove duplicate route registration

senamakel
and
medullabot
committed
cc75b77
fix(cortex): correct test module path for direct and consolidate tests

senamakel
and
medullabot
committed
6384a32
test(cortex-engine): clone engine before store_with in test

senamakel
and
medullabot
committed
1a6cfb8
feat(cortex): add source scope to namespace documentation and test

senamakel
and
medullabot
committed
631def4
fix(render): handle empty recall context in template rendering

senamakel
and
medullabot
committed
a0a90fa
fix(render): handle empty recall results gracefully

senamakel
and
medullabot
committed
e6649ec
fix(recall): correct test assertion for render output

senamakel
and
medullabot
committed
45ee82c
fix(recall): handle empty gather results gracefully

senamakel
and
medullabot
committed
0c6d347
fix(recall): handle empty gather set without panic

senamakel
and
medullabot
committed
2ee7e93
fix(context): handle missing compile context gracefully

senamakel
and
medullabot
committed
500f147
feat(recall): add concurrent holistic recall module

senamakel
and
medullabot
committed
c1a82be
fix(tests): add missing ListRequest and RecallRequest imports

senamakel
and
medullabot
committed
6102fc7
fix(consolidate): derive Hash on ConsolidateRequest

senamakel
and
medullabot
committed
4a78959
test(layout): add missing import for SourceKind in layout tests

senamakel
and
medullabot
committed
108a63e
chore(tinymemory-tools): add background module

senamakel
and
medullabot
committed
fae7c06
fix(background): clarify deduplication mechanism in doc comment

senamakel
and
medullabot
committed
33818a8
feat(recall): deduplicate items across sections and add timestamps

senamakel
and
medullabot
committed
c9d02f6
fix(lifecycle): handle untracked file in lifecycle module

senamakel
and
medullabot
committed
e6cf5d3
feat(tinymemory-tools): add lifecycle module and background/brain test suites

senamakel
and
medullabot
committed
96887a0
feat(recall): deduplicate items across sections without hiding answer citations

senamakel
and
medullabot
committed
0b33be4
chore: reformat long function signatures and expressions across multiple crates

senamakel
and
medullabot
committed
ccd550c
fix(lifecycle): use is_multiple_of for turn index check

senamakel
and
medullabot
committed
7cce299
fix(brain): handle missing memory file on startup

senamakel
and
medullabot
committed
8751682
chore(tinymemory-integrations): add initial crate structure

senamakel
and
medullabot
committed
a3b8246
feat(cortex): add lifecycle test module

senamakel
and
medullabot
committed
2c02383
chore(examples): add onboarding and refund policy fixture files

senamakel
and
medullabot
committed
3d480f7
feat(tinymemory-tools): add agent loop and brain examples

senamakel
and
medullabot
committed
3efbf48
feat(recall): improve context selection and document display

senamakel
and
medullabot
committed
786dc45
feat(examples): add cortex agent example

senamakel
and
medullabot
committed
499ce70
chore: reformat code and adjust example turn indices

senamakel
and
medullabot
committed
d5ca3e6
feat(tinymemory-integrations): add live cortex lifecycle test

senamakel
and
medullabot
committed
505acf7
chore(scripts): add agent lifecycle live test to cortexdb-live.sh

senamakel
and
medullabot
committed
e7baa92
docs(specs): add agent memory specification

senamakel
and
medullabot
committed
8b83fe5
docs(agent-memory): add initial design document for agent memory

senamakel
and
medullabot
committed
bdde707
fix(recall): strip duplicate heading from document bullet text

senamakel
and
medullabot
committed
06cce6d
docs(architecture): add lifecycle documentation

senamakel
and
medullabot
committed
6bae4c5
feat(docs): document the agent memory lifecycle and brain feature

senamakel
and
medullabot
committed
6d7d44b
docs(tinymemory-tools): document agent lifecycle and holistic recall

senamakel
and
medullabot
committed
d6fc144
test: reformat long assertions in recall test for readability

senamakel
and
medullabot
committed
363fbc4
fix(docs): remove unnecessary path qualification in doc comment

senamakel
and
medullabot
committed
1749b07
fix(lifecycle): use fully qualified path for WaitFor in doc comment

senamakel
and
medullabot
committed
7f88126
feat(agent): add memory evaluation example

senamakel
and
medullabot
committed
cea1470
feat(tinymemory-integrations): add memory evaluation scenario example

senamakel
and
medullabot
committed
59240d8
feat(score): add memory evaluation scoring example

senamakel
and
medullabot
committed
b572308
fix(score): correct score calculation for memory evaluation

senamakel
and
medullabot
committed
7ac2f43
chore(examples): remove unused inspect example

senamakel
and
medullabot
committed
5f01546
feat(tinymemory-integrations): add memory evaluation example

senamakel
and
medullabot
committed
4399055
feat(tinymemory-integrations): add memory_eval example

senamakel
and
medullabot
committed
4f9ba3d
feat(tinymemory-integrations): add chrono, serde, and serde_json dependencies

senamakel
and
medullabot
committed
b250e1e
chore(memory_eval): narrow visibility of example types and functions

senamakel
and
medullabot
committed
a9a6abf
fix(agent): extract "not in memory" string into a constant

senamakel
and
medullabot
committed
732feb3
fix(agent): use as_ref to avoid moving score in closure

senamakel
and
medullabot
committed
1bd8815
fix(integrations): correct memory evaluation example to use proper LLM interface

senamakel
and
medullabot
committed
82e1dec
feat(score): add memory evaluation scoring example

senamakel
and
medullabot
committed
55ef43e
feat(integrations): add memory evaluation example

senamakel
and
medullabot
committed
5147876
feat(memory_eval): add model answer column and show both phases in summary tables

senamakel
and
medullabot
committed
7b3e90b
refactor(memory_eval): extract eval runner into a struct

senamakel
and
medullabot
committed
cfcabb3
refactor(example): convert settle to a method on Eval

senamakel
and
medullabot
committed
659c2f5
chore: files changed crates/tinymemory-api/src/conformance/reference/mod.rs,crates/tinymemory-api/sr

senamakel
and
medullabot
committed
da491d2
test(background): replace map-based assertion with explicit receipt check

senamakel
and
medullabot
committed
c408bf3
feat(cortex): handle synchronous build responses from CortexDB v0.10

senamakel
and
medullabot
committed
21303c3
fix(cortex): parallelise scope recall in fetch to reduce latency

senamakel
and
medullabot
committed
7a452a8
feat(recall): prefix conversation bullets with timestamp when available

senamakel
and
medullabot
committed
77e0120
feat(memory_eval): track built beliefs and pass probe questions to inspector

senamakel
and
medullabot
committed
3daccfd
chore(scripts): add memory evaluation script

senamakel
and
medullabot
committed
110df45
chore(scripts): make memory-eval.sh executable

senamakel
and
medullabot
committed
d013bb3
docs(consolidate): document synchronous belief builds and read visibility

senamakel
and
medullabot
committed
5dbafcb
feat(lifecycle): add timestamp display for turn bullets

senamakel
and
medullabot
committed
aa92161
fix(lifecycle): sample every dropped turn in the gist

senamakel
and
medullabot
committed
676eea8
docs(architecture): clarify recall_for_compaction turn selection and gist

senamakel
and
medullabot
committed
db9df44
fix(test): correct expected job outcome for direct wire in lifecycle test

senamakel
and
medullabot
committed
382f816
docs(evals): add README for evaluation framework

senamakel
and
medullabot
committed
059fa07
docs(evals): document the agent memory eval and add evals directory to docs

senamakel
and
medullabot
committed
e1358e2
feat(memory_eval): add accept field to Probe for alternative correct answers

senamakel
and
medullabot
committed
c14985f
feat(score): support accepted wordings in probe grading

senamakel
and
medullabot
committed
5db58ce
docs(agent-memory): add documentation for agent memory evaluation

senamakel
and
medullabot
committed
5522004
docs(evals): update agent-memory evaluation numbers

senamakel
and
medullabot
committed
0fd4ee9
docs(agent-memory): add evaluation script and results reference to plan

senamakel
and
medullabot
committed
e421743
fix(scripts): include port in docker compose project name

senamakel
and
medullabot
committed
a48001f
chore: files changed crates/tinymemory-integrations/examples/memory_eval/scenarios.rs

senamakel
and
medullabot
committed
aedbfd5
chore: files changed crates/tinymemory-integrations/examples/memory_eval/main.rs,crates/tinymemory-i

senamakel
and
medullabot
committed
9bf47ad
chore: files changed crates/tinymemory-integrations/examples/memory_eval/inspect.rs

senamakel
and
medullabot
committed
ad42b85
chore: files changed crates/tinymemory-integrations/examples/memory_eval/main.rs,crates/tinymemory-i

senamakel
and
medullabot
committed
0919865
chore: files changed crates/tinymemory-integrations/examples/memory_eval/main.rs

senamakel
and
medullabot
committed
0722161
chore: files changed docs/evals/README.md,scripts/memory-eval.sh

senamakel
and
medullabot
committed
35bcade
feat(memory_eval): increase max_tokens and disable reasoning for LLM calls

senamakel
and
medullabot
committed
a96cb03
fix(example): increase token limit and adjust reasoning config for GLM models

senamakel
and
medullabot
committed
c281f22
feat(memory_eval): wait for enrichment queue to drain instead of fixed sleep

senamakel
and
medullabot
committed
112a5d3
docs(evals): document longer enrich-wait and model compatibility

senamakel
and
medullabot
committed
1dce71b
chore: files changed crates/tinymemory-integrations/examples/memory_eval/inspect.rs,crates/tinymemor

senamakel
and
medullabot
committed
137ae87
feat(consolidate): add belief reading API

senamakel
and
medullabot
committed
a3a059e
feat(conformance): add beliefs conformance checks to lifecycle suite

senamakel
and
medullabot
committed
196228b
test(conformance): add belief fault cases to conformance reference

senamakel
and
medullabot
committed
2a82861
feat(recall): interleave engine beliefs with stored learnings in fetched and latest sections

senamakel
and
medullabot
committed
be8ee0f
test(recall): add test harness and integration tests for belief merging in learnings sections

senamakel
and
medullabot
committed
2bfddaa
chore: files changed crates/tinymemory-integrations/src/cortex/testing/log.rs,crates/tinymemory-inte

senamakel
and
medullabot
committed
52ad8a5
chore: files changed crates/tinymemory-integrations/src/cortex/descriptor/mod.rs,crates/tinymemory-i

senamakel
and
medullabot
committed
37a9427
chore: files changed crates/tinymemory-integrations/src/cortex/engine/beliefs.rs

senamakel
and
medullabot
committed
47cc1b1
feat(cortex): add beliefs endpoint to CortexEngine

senamakel
and
medullabot
committed
c2b510c
fix(cortex): reorder imports to use tinymemory_api re-exported chrono types

senamakel
and
medullabot
committed
98d9b23
test: simplify belief equality assertion in scope test

senamakel
and
medullabot
committed
a9c4ccd
test(consolidate): correct expected built count in test assertion

senamakel
and
medullabot
committed
4a04199
chore: files changed crates/tinymemory-integrations/src/cortex/lifecycle_tests.rs

senamakel
and
medullabot
committed
12d2756
docs(cortex): clarify how built beliefs are read back

senamakel
and
medullabot
committed
ddbb641
docs(architecture, specs): document how built beliefs reach the Learnings section

senamakel
and
medullabot
committed
03efaba
chore: files changed crates/tinymemory-api/src/conformance/reference/mod.rs,crates/tinymemory-api/sr

senamakel
and
medullabot
committed
d7ef4c1
chore: files changed crates/tinymemory-api/src/query/mod.rs,crates/tinymemory-tools/src/tools/read/m

senamakel
and
medullabot
committed
2012b65
chore: files changed crates/tinymemory-integrations/src/cortex/engine/beliefs.rs,crates/tinymemory-i

senamakel
and
medullabot
committed
fc59be9
chore: files changed crates/tinymemory-tools/src/recall/gather.rs,crates/tinymemory-tools/src/recall

senamakel
and
medullabot
committed
de482f7
chore: files changed crates/tinymemory-tools/src/recall/mod_tests.rs

senamakel
and
medullabot
committed
824915a
chore: files changed crates/tinymemory-tools/src/recall/mod_tests.rs

senamakel
and
medullabot
committed
ab2dead
chore: files changed crates/tinymemory-integrations/src/cortex/engine/beliefs_tests.rs

senamakel
and
medullabot
committed
583c36b
chore: files changed docs/integration.md

senamakel
and
medullabot
committed
08677db
chore: files changed README.md,docs/README.md,docs/evals/agent-memory.md

senamakel
and
medullabot
committed
5b56a96
chore: files changed docs/architecture/cortex-wire.md,docs/architecture/lifecycle.md,docs/specs/agen

senamakel
and
medullabot
committed
5cd0235