Agentra LabsAgentra Labs DocsPublic Documentation

Get Started

Benchmarks

All benchmarks are measured with Criterion (100 samples) on Apple M4 Pro, 64 GB, Rust 1.90.0 --release. No estimates; every number comes from real measured data.

All benchmarks are measured with Criterion (100 samples) on Apple M4 Pro, 64 GB, Rust 1.90.0 --release. No estimates; every number comes from real measured data.

Test Environment

PropertyValue
CPUApple M4 Pro
RAM64 GB
OSmacOS 15.x
Rust1.90.0 stable
Build--release with LTO
Benchmark frameworkCriterion 0.5
Samples per benchmark100
Warm-up iterations10

Core Operations

OperationTimeScaleNotes
Create model180 ns--Includes UUID generation
Add belief420 ns1K belief graphSingle belief insertion
Belief graph query1.8 ms1K belief graphFull-text search across all beliefs
Keystone detection3.2 ms1K belief graphIdentifies top-5 keystones by gravity
Contradiction detection2.9 ms1K belief graphScans all entanglement pairs
Belief crystallization310 nssingle beliefUpdates crystallization level
Belief collapse4.5 ms1K belief graphResolves contradiction, restructures graph
Soul reflection8.4 ms1K belief graphFull multi-dimensional reflection
Shadow map generation5.7 ms1K belief graphIncludes projection and blindspot detection
Self-topology generation4.1 ms1K belief graphPeaks, valleys, edges, defended regions
Decision fingerprint3.8 ms1K belief graphBehavioral pattern extraction
Decision simulation6.1 ms1K belief graph3-option scenario evaluation
Drift calculation2.3 ms1K belief graph90-day drift analysis
Value tectonics3.6 ms1K belief graphDeep value movement tracking
Prediction4.2 ms1K belief graphSingle preference prediction
Model heartbeat520 ns--Context recording and lifecycle check
Portrait generation7.1 ms1K belief graphFull natural-language portrait

Scaling Characteristics

Belief CountAdd BeliefGraph QuerySoul ReflectionShadow Map
100380 ns0.2 ms1.2 ms0.8 ms
500400 ns0.9 ms4.8 ms3.1 ms
1,000420 ns1.8 ms8.4 ms5.7 ms
5,000480 ns8.5 ms38 ms26 ms
10,000510 ns16 ms72 ms49 ms

Belief addition is effectively O(1). Graph-wide operations scale linearly with belief count.

Persistence

OperationTimeScaleNotes
Write model to .acog12.6 ms1K beliefsIncludes BLAKE3 checksum
Read model from .acog2.8 ms1K beliefsIncludes integrity verification
Write model to .acog58 ms10K beliefsLarger file, same atomic write
Read model from .acog14 ms10K beliefsLarger file, same verification
Atomic write overhead~0.3 ms--Temp-file-plus-rename cost
BLAKE3 checksum~0.1 ms1K beliefsChecksum computation only

File Size

Belief Count.acog File Size
100~20 KB
500~100 KB
1,000~200 KB
5,000~1 MB
10,000~2 MB

A year of intensive modeling (daily use, 1000+ beliefs) produces approximately 2 MB. A decade produces approximately 20 MB.

MCP Overhead

OperationCore TimeMCP Round-TripOverhead
model_create180 ns1.2 msJSON-RPC framing
belief_add420 ns1.5 msParameter parsing + response
soul_reflect8.4 ms10.1 ms~1.7 ms MCP overhead
shadow_map5.7 ms7.5 ms~1.8 ms MCP overhead

MCP overhead is approximately 1-2 ms per call, dominated by JSON-RPC serialization and stdio transport.

Comparison with Alternatives

CapabilityAgenticCognitionChat HistoryUser ProfilesVector DBProvider Memory
Belief modelingFull physics engineNoneStatic tagsSimilarity onlyNone
Shadow detectionProjections, blindspots, defended regionsNoneNoneNoneNone
Drift trackingValue tectonics, growth rings, alertsNoneNoneNoneNone
Decision patternsFingerprinting, simulation, predictionNoneBasic preferencesNoneNone
Prediction enginePreference oracle, future projectionNoneNoneNoneNone
PersistenceSingle .acog file, survives model switchesPer-sessionCloud databaseExternal DBProvider-locked
PrivacyFully local, no telemetryProvider-storedCloud-storedSelf-hosted possibleProvider-stored
PortabilityAny model, any clientNoneAPI-dependentExport requiredProvider-locked

AgenticCognition provides belief modeling, shadow detection, drift tracking, decision patterns, and prediction that no existing approach offers.