How v1b3x0r/mds works
MDS is a deterministic TypeScript runtime for small semantic worlds. Its central workflow is: an application supplies context and authored .mdm materials; the World turns that input into entity and world state, where behavior can produce speech, logs, and effects. The graph preserves the README’s major capabilities—ontology, physics, cognition, communication, linguistics, resources, networking, rendering, and persistence. Several feature connections are documented but their internal dispatch is not shown in the excerpts, so those links are omitted rather than inferred.
Main entry points: container.ts World Container · entity.ts Entities · engine.ts Simulation Engine · mdm-parser.ts MDM Materials
Components 21
World Runtime
- World Container
src/6-world/container.ts - Simulation Engine
src/0-foundation/engine.ts
Entity State
- Entities
src/0-foundation/entity.ts - Memory, Emotion, Intent
src/1-ontology - Relationships
src/1-ontology/relationships
World Capabilities
- Physics and Weather
src/2-physics - Learning and Skills
src/3-cognition - Collective Intelligence
src/3-cognition/world-mind - Dialogue
src/4-communication/dialogue/manager.ts - Language Generation
src/4-communication/language/generator.ts - Semantic Similarity
src/4-communication/semantics/embeddings.ts - Peer Network
src/5-network - Resource Fields
src/6-world/resources/field.ts - Proto-language
src/6-world/linguistics
Inputs and Outputs
- MDM Materials
src/7-interface/io/mdm-parser.ts - Context Providers
src/7-interface/context - Optional LLM Bridge
src/7-interface/io/llmAdapter.ts - Render Adapters
src/7-interface/render - Worldfile Persistence
src/7-interface/io/worldfile.ts - World Logger
src/6-world/logger.ts
Other components
- Host Application
Connections 20
- Host Application → World Container: feeds context
README.md - Host Application → World Container: spawns materials
README.md - MDM Materials → World Container: defines responses
README.md - Context Providers → World Container: supplies context
README.md - World Container → Entities: manages state
README.md - World Container → World Logger: uses logger
src/6-world/container.ts - Simulation Engine → Entities: spawns
src/0-foundation/engine.ts - World Container → Dialogue: produces speech
- World Container → Proto-language: generates utterances
- World Container → Render Adapters: renders world
- World Container → Worldfile Persistence: saves state
- World Container → Physics and Weather: applies effects
- World Container → Memory, Emotion, Intent: updates state
- World Container → Relationships: updates bonds
- World Container → Learning and Skills: supports learning
- World Container → Collective Intelligence: supports collectives
- World Container → Resource Fields: models resources
- World Container → Peer Network: supports peers
- World Container → Semantic Similarity: uses similarity
- World Container → Optional LLM Bridge: requests generation