broomva/sensorium

Sensorium — exteroceptive substrate for the Life Agent OS, input layer of MIL (Multimodal Intent Language)

Rust

1

14 commits

updated Jun 27, 2026

See the code

README

Sensorium — sensory apparatus for the Life Agent OS

Multimodal input substrate for MIL — the Multimodal Intent Language. Sensorium turns world observations into typed PrimitiveToken streams and a queryable WorkspaceContext. It is exteroception (the world → the agent), the dual of Vigil (proprioception, the agent → itself).

Crates

CrateRoleTests
sensorium-coreSubstrate types — WorkspaceContext, WorkspaceSnapshot, PrimitiveToken, Tagged<T>, privacy markers, ring buffer, calibrated provenance. No I/O.81
sensorium-contextPull-based Observer trait + ManualObserver (tests/demos) + FsObserver (notify-based, real-world tokens). Phase 1.1.13
sensorium-context-macosmacOS workspace observer — polls NSWorkspace for the frontmost application. Step #15.4 + 1 ignored
sensorium-voiceVoice-input substrate — SpeechToText trait + MockStt + VoiceSession + VAD layer (VadModel + MockVad + SileroVad + VadGate). Step #17. feature = "audio" adds cpal mic capture + Silero V5 VAD; feature = "parakeet" (deferred) adds Parakeet TDT EOU inference.28 (+ 2 with audio, +1 ignored mic)

Total tests: 126 · 2 ignored (interactive) · all green on cargo test --workspace.

Future Phase-1.2+ crates (not yet built): sensorium-context-macos (NSWorkspace + Accessibility API), sensorium-vision (MediaPipe / WiLoR), sensorium-voice (Whisper streaming), sensorium-gaze (eye tracking), sensorium-headset (Quest 3 / Vision Pro), sensorium-lago (replay journal bridge).

Status

v0.2.0 — Phase 1.1 of the MIL build order shipped. The Observer trait is the boundary between Sensorium (which produces world observations) and Pneuma (which consumes them as WorkspaceContext). FsObserver is the first observer that produces real-world tokens; downstream the pneuma-demo binary takes Box<dyn Observer> so callers can swap ManualObserver (tests) for FsObserver (the rename demo) at runtime.

What's wired up today

broomva/pneuma's demo binary depends on sensorium-context via a path dependency (../sensorium). That demo runs the full pipeline end-to-end on a tempdir: an FsObserver watches the tempdir, a directive parses out of an MIL_UTTERANCE env var, the router dispatches to the Praxis bridge, the journal records the run, and the HUD prints frames. See MIL-PROJECT.md §10 for the full crate-by-crate breakdown and docs/mil/progress-snapshot-tier-2-complete.md for the current state across both repos.

Cross-references

Contributors

broomva

14 commits

broomva/sensorium

Sensorium — exteroceptive substrate for the Life Agent OS, input layer of MIL (Multimodal Intent Language)

Rust

1

14 commits

updated Jun 27, 2026

See the code

README

Sensorium — sensory apparatus for the Life Agent OS

Multimodal input substrate for MIL — the Multimodal Intent Language. Sensorium turns world observations into typed PrimitiveToken streams and a queryable WorkspaceContext. It is exteroception (the world → the agent), the dual of Vigil (proprioception, the agent → itself).

Crates

CrateRoleTests
sensorium-coreSubstrate types — WorkspaceContext, WorkspaceSnapshot, PrimitiveToken, Tagged<T>, privacy markers, ring buffer, calibrated provenance. No I/O.81
sensorium-contextPull-based Observer trait + ManualObserver (tests/demos) + FsObserver (notify-based, real-world tokens). Phase 1.1.13
sensorium-context-macosmacOS workspace observer — polls NSWorkspace for the frontmost application. Step #15.4 + 1 ignored
sensorium-voiceVoice-input substrate — SpeechToText trait + MockStt + VoiceSession + VAD layer (VadModel + MockVad + SileroVad + VadGate). Step #17. feature = "audio" adds cpal mic capture + Silero V5 VAD; feature = "parakeet" (deferred) adds Parakeet TDT EOU inference.28 (+ 2 with audio, +1 ignored mic)

Total tests: 126 · 2 ignored (interactive) · all green on cargo test --workspace.

Future Phase-1.2+ crates (not yet built): sensorium-context-macos (NSWorkspace + Accessibility API), sensorium-vision (MediaPipe / WiLoR), sensorium-voice (Whisper streaming), sensorium-gaze (eye tracking), sensorium-headset (Quest 3 / Vision Pro), sensorium-lago (replay journal bridge).

Status

v0.2.0 — Phase 1.1 of the MIL build order shipped. The Observer trait is the boundary between Sensorium (which produces world observations) and Pneuma (which consumes them as WorkspaceContext). FsObserver is the first observer that produces real-world tokens; downstream the pneuma-demo binary takes Box<dyn Observer> so callers can swap ManualObserver (tests) for FsObserver (the rename demo) at runtime.

What's wired up today

broomva/pneuma's demo binary depends on sensorium-context via a path dependency (../sensorium). That demo runs the full pipeline end-to-end on a tempdir: an FsObserver watches the tempdir, a directive parses out of an MIL_UTTERANCE env var, the router dispatches to the Praxis bridge, the journal records the run, and the HUD prints frames. See MIL-PROJECT.md §10 for the full crate-by-crate breakdown and docs/mil/progress-snapshot-tier-2-complete.md for the current state across both repos.

Cross-references

Contributors

broomva

14 commits

Languages

Rust

100.0%