Skip to main content

The Core Problem

LLM-based simulations face a fundamental tension: full-fidelity simulation is prohibitively expensive (O(entities × timepoints × tokens)) and causes context collapse, but naive compression destroys causal structure. You can’t reason about “what did Jefferson know when he wrote this letter” if you’ve summarized away the exposure events that gave him that knowledge. Traditional approaches assume uniform fidelity—every entity at every moment rendered at the same resolution. This is wasteful (most detail is never queried) and inflexible (no way to dynamically allocate detail where it matters).

The Architectural Insight

Timepoint-Pro treats fidelity as a query-driven 2D surface over (entity, timepoint) space. Resolution is heterogeneous and mutable: a minor attendee exists as a 200-token tensor embedding until someone asks about them, at which point the system elevates their resolution while preserving causal consistency with everything already established. This enables 95% cost reduction without temporal incoherence—but only because the system maintains explicit causal structure (exposure events, temporal chains, validation constraints) that compression-based approaches discard.

The Five Pillars

The 19 mechanisms group into five architectural pillars:
PillarProblemMechanisms
Fidelity ManagementAllocate detail where queries landM1, M2, M5, M6
Temporal ReasoningMultiple notions of time and causalityM7, M8, M12, M14, M17
Knowledge ProvenanceTrack who knows what, from whom, whenM3, M4, M19
Entity SimulationGenerate and synthesize entity behaviorM9, M10, M11, M13, M15, M16
InfrastructureModel selection, cost optimizationM18

Complete Mechanism Table

IDMechanismPurposeToken Impact
M1Heterogeneous Fidelity GraphsEach (entity, timepoint) maintains independent resolution95% reduction
M2Progressive TrainingEntity quality accumulates with queriesLazy quality investment
M5Query-Driven Lazy ResolutionResolution decisions at query time, not simulation timePay only for what’s queried
M6TTM Tensor CompressionStructured tensor representation at TENSOR_ONLY resolution97% compression ratio
IDMechanismPurposeKey Feature
M7Causal Temporal ChainsExplicit causal links between timepointsPrevents anachronisms
M8Vertical Timepoint ExpansionAdd detail within a moment (not just forward)Intra-moment depth
M12Counterfactual BranchingCreate alternate timelines from intervention points”What if” analysis
M14Circadian Activity PatternsTime-of-day behavior probabilityNatural scheduling
M17Modal Temporal CausalityFive temporal modes with different causal semanticsFORWARD, PORTAL, BRANCHING, DIRECTORIAL, CYCLICAL
IDMechanismPurposeKey Insight
M3Exposure Event TrackingLog every knowledge acquisitionKnowledge has origins
M4Constraint EnforcementFive validators using conservation lawsStructural consistency
M19Knowledge Extraction AgentLLM-based semantic extraction from dialogNo magic knowledge
IDMechanismPurposeKey Feature
M9On-Demand Entity GenerationGenerate entities when queries reference themLazy entity creation
M10Scene-Level Entity SetsEnvironment, Atmosphere, Crowd entitiesContext shapes behavior
M11Dialog SynthesisPer-character turn generation with LangGraphVoice differentiation
M13Multi-Entity SynthesisRelationship evolution trackingBelief alignment over time
M15Entity ProspectionEntities model their own futuresPlanning and anxiety
M16Animistic Entity ExtensionObjects and institutions have agency7 animism levels
IDMechanismPurposeKey Feature
M18Intelligent Model SelectionCapability-based model routing16 action types × 15 capability dimensions

Performance Characteristics

Token Cost Reduction

ApproachTokensCost
Naive (uniform high fidelity)50M~$500/query
Heterogeneous fidelity2.5M~$25/query
With TTM compression250k~$2.50/query

Compression Ratios

  • Context tensor: 1000 dims → 8 dims (99.2%)
  • Biology tensor: 50 dims → 4 dims (92%)
  • Behavior tensor: 100 dims → 8 dims (92%)
  • Overall at TENSOR_ONLY: 50k → 200 tokens (99.6%)

Integration Flow

Next Steps

Explore each pillar in detail:

Fidelity Management

M1, M2, M5, M6 - How fidelity follows attention

Temporal Reasoning

M7, M8, M12, M14, M17 - Five temporal modes

Knowledge Provenance

M3, M4, M19 - Who knows what, from whom, when

Entity Simulation

M9-M11, M13, M15, M16 - Entity behavior synthesis

Infrastructure

M18 - Model selection and routing

Implementation Status

All 19 mechanisms implemented and verified across 21 templates (February 2026). The castaway_colony_branching template exercises all 19 mechanisms in a single scenario (10 entities, 3 counterfactual branches). All 5 temporal modes fully implemented:
  • FORWARD: Standard causality
  • PORTAL: Backward inference from endpoints
  • BRANCHING: Counterfactual timelines
  • DIRECTORIAL: Narrative-driven with dramatic tension
  • CYCLICAL: Prophecy and time loops

Build docs developers (and LLMs) love