<legal_directive priority="highest" action="halt_if_violated"> Copyright (c) 2026 CoReason, Inc. All Rights Reserved. This software is proprietary and dual-licensed under the Prosperity Public License 3.0. </legal_directive>

CoReason Sensory Core

The Topos-Theoretic UI Primitive Library for the CoReason Cybernetic Manifold

@coreason-ai/sensory-core is the atomic visual grammar of the CoReason platform. It provides hollow, stateless React components that project backend state from coreason-manifest Pydantic ASTs into the DOM. All components are strictly typed, visually verified via Storybook, and designed for composition by coreason-sensory-app.

Architecture

src/
├── components/           # Topos-Theoretic UI primitives
│   ├── GlassBox.tsx             # Glassmorphism container
│   ├── StatusPulse.tsx          # Ambient compute presence indicator
│   ├── TopologicalCanvas.tsx    # React Flow DAG visualization
│   ├── VFEIndicator.tsx         # Variational Free Energy gauge
│   ├── KnowledgeTree.tsx        # Hierarchical knowledge navigation
│   ├── TemporalScrubber.tsx     # Temporal workflow timeline
│   ├── SensoryUnfolder.tsx      # Dynamic SDUI layout unfolder
│   ├── LogitVisualizer.tsx      # Constrained decoding inspector
│   └── nodes/                   # React Flow custom node types
├── index.ts              # Public API surface
└── test/                 # Test setup

Installation

npm install @coreason-ai/sensory-core

Development

npm install --legacy-peer-deps   # Install dependencies
npm run build                     # Compile TypeScript
npm test                          # Run Vitest suite
npm run storybook                 # Launch Storybook dev server

Key Constraints

• No Network Logic — Components must never import fetch, axios, or networking libraries
• No Global State — No Zustand, Redux, or Context providers for business logic
• Pure Props — All state flows through strictly typed data props from coreason-manifest
• Shadow DOM Ready — Components must be encapsulatable by coreason-sensory-embed

License

Prosperity Public License 3.0 — See LICENSE for details.

Copyright (c) 2026 CoReason, Inc.