Synapse Core

Thermodynamic Physics

Sulcus treats the LLM context window as a bounded physical budget governed by Map vs Territory paging, Dynamic Skills VMMU stubs, interaction-epoch clocks, spaced-repetition stability, and 2-hop graph resonance.

Map And TerritoryInteraction Epoch ClockSpaced StabilityTwo Hop Resonance
Virtual Memory Paging

Proactive Paging Lifecycle

Instead of dumping thousands of raw chunk tokens into every prompt, Sulcus separates compact semantic pointers (the Map) from full source artifacts and skill playbooks (the Territory).

Phase One

PreInvocation Hydration

Before token generation, sulcus hook queries /api/v1/agent/hot-context to inject budgeted <sulcus-memories>, <sulcus-peers>, and skill stubs.

Phase Two

Map Pointer Scan

The model evaluates compact pointer summaries and Dynamic Skills VMMU headers inside its working context budget.

Phase Three

Territory Page Fault

When line-level precision is required, MCP expand_memory or use_skill loads exact sections and reinforces heat by +0.15.

Phase Four

Single Pass Ingest

At turn completion, /api/v1/agent/ingest embeds once, prepares via MemPalace, gates via System 1 VCR, and fires triggers.

Dynamic Skills VMMU

Procedural playbooks indexed via sulcus skill ingest participate in the same Map vs Territory paging discipline through skills_index. Agents see ultra-compact skill capability pointers upfront and call sulcus skill fault (or MCP use_skill) only when executing that specific workflow.
Decay Physics

Clocks And Stability

If your engineering team takes a long weekend off, project memories should not evaporate by Monday morning. Sulcus defaults tenants to interaction-epoch decay rather than naive wall-clock timers.

Default Mode

Interaction Epoch

Advances the decay clock (decay_mode = "interaction") only when agents store, search, or ingest turns in your tenant. Weekends and holidays cause zero decay.
Calendar Mode

Wall Clock Time

Decays strictly by elapsed wall-clock seconds (half_life_secs via decay_mode = "time"). Ideal for strictly time-expiring operational telemetry.
Dual Mode

Hybrid Clock

Applies min(time_decay, interaction_decay) on every tick so high-velocity agent bursts and long calendar gaps both cool stale episodes.
pythonThermodynamic Decay Formula
effective_half_life = profile.half_life_secs * decay_class.multiplier() * stability
decay_factor        = 2^(-tick_interval_secs / effective_half_life)

# Applied on each tick (is_pinned and decay_class="permanent" nodes never decay):
next_heat = max(node.min_heat ?? profile.floor, current_heat * decay_factor)
ArchetypeWall Half LifeInteraction OpsHeat FloorRecall BoostStability Gain
episodic86,400s (24h)50 ops0.01+0.201.3x
semantic2,592,000s (30d)500 ops0.05+0.101.5x
synthesis5,184,000s (60d)800 ops0.05+0.101.5x
preference7,776,000s (90d)1,000 ops0.10+0.151.8x
procedural15,552,000s (180d)2,000 ops0.08+0.102.0x
fact31,536,000s (365d)5,000 ops0.15+0.052.5x

Node Retention Overrides

Every node supports decay_class (volatile = 0.5x, normal = 1.0x, persistent = 2.0x, permanent = infinity), a custom min_heat floor (0.0..1.0), and is_pinned = true (exempt from decay and prioritized in active working memory).
Spreading Activation

Edge Resonance Tuning

When a memory is recalled or boosted, thermal energy propagates across connected Knowledge Graph edges up to depth = 2 hops (spread_factor = 0.30, damping = 0.50 per hop, thermal_gate = 0.05).

bashTenant Thermo Tuning
# Inspect or customize your tenant ThermoConfig
curl -X PATCH https://api.sulcus.ca/api/v1/settings/thermo \
  -H "Authorization: Bearer $SULCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "decay_mode": "interaction",
    "decay_profiles": {
      "episodic":   { "half_life_secs": 86400,    "half_life_interactions": 50,   "floor": 0.01, "reinforce_on_recall": 0.20, "stability_gain": 1.3 },
      "semantic":   { "half_life_secs": 2592000,  "half_life_interactions": 500,  "floor": 0.05, "reinforce_on_recall": 0.10, "stability_gain": 1.5 },
      "synthesis":  { "half_life_secs": 5184000,  "half_life_interactions": 800,  "floor": 0.05, "reinforce_on_recall": 0.10, "stability_gain": 1.5 },
      "preference": { "half_life_secs": 7776000,  "half_life_interactions": 1000, "floor": 0.10, "reinforce_on_recall": 0.15, "stability_gain": 1.8 },
      "procedural": { "half_life_secs": 15552000, "half_life_interactions": 2000, "floor": 0.08, "reinforce_on_recall": 0.10, "stability_gain": 2.0 },
      "fact":       { "half_life_secs": 31536000, "half_life_interactions": 5000, "floor": 0.15, "reinforce_on_recall": 0.05, "stability_gain": 2.5 }
    },
    "resonance": {
      "spread_factor": 0.30,
      "depth": 2,
      "damping": 0.50,
      "thermal_gate": 0.05
    }
  }'
Engineering Dispatches

Architecture Release Notes

Receive technical deep dives on thermodynamic context engineering, System 1 VCR cartridge updates, SulcusBench evaluations, and signed v3.1 engine releases directly from Digital Forge Studios.