Package reference
Hypha v1.0.1 is published as 15 packages under @codesoul-co. Pin every package in one application to the same release line.
bash
npm install @codesoul-co/hypha-core@1.0.1 \
@codesoul-co/hypha-fsm@1.0.1 \
@codesoul-co/hypha-domain@1.0.1 \
@codesoul-co/hypha-kernel@1.0.1 \
@codesoul-co/hypha-harness@1.0.1Select by layer
| Layer | Packages | Use it for |
|---|---|---|
| Contracts | hypha-core, hypha-storage | Shared specs, Events, policy and storage topology |
| Execution | hypha-fsm, hypha-kernel, hypha-harness | State transitions, ReAct loops and durable runtime boundaries |
| Intelligence | hypha-models, hypha-inference | Model adapters, aliases, normalized inference and cache coordination |
| Capabilities | hypha-memory, hypha-skills, hypha-tools, hypha-mcp | Context and governed effects |
| Product composition | hypha-domain | Application-owned Domain Packs and Workflow specs |
| Providers | hypha-adapters-local, hypha-serving-cache | Local storage composition and bounded serving cache |
| Verification | hypha-testing | Replay fixtures and deterministic FSM assertions |
APPLICATION / DOMAIN PACK
↓ domain · skills · tools · mcp · memory
↓ kernel · harness · fsm
↓ models · inference · storage · local adapters · cache
EVENTS → REPLAY → TESTING
↓ domain · skills · tools · mcp · memory
↓ kernel · harness · fsm
↓ models · inference · storage · local adapters · cache
EVENTS → REPLAY → TESTING
Public package matrix
| Package | Primary boundary | Typical entry point |
|---|---|---|
hypha-core | Versioned framework contracts | createFrameworkEvent |
hypha-storage | Provider-neutral storage profiles | createSQLiteStorageProfile |
hypha-fsm | Validated FSM topology/runtime | parseFSMProcessSpec |
hypha-kernel | ReAct reasoning contracts | reactAgentSpecDefinition |
hypha-harness | Event-first execution and projection | SessionProjector |
hypha-models | Model providers and routing | ModelRegistry |
hypha-inference | Normalized inference backend | InferenceManager |
hypha-memory | Governed scoped memory | memorySpecDefinition |
hypha-skills | Progressive instruction loading | SkillRegistry |
hypha-tools | Typed governed tool execution | ToolRegistry |
hypha-mcp | Governed MCP integration | mcpIntegrationSpecDefinition |
hypha-domain | Domain Pack compilation | compileDomainPackToHarnessedSystem |
hypha-adapters-local | Local provider composition | createLocalStorageBackbone |
hypha-serving-cache | Scoped response cache | ServingCacheManager |
hypha-testing | Replay/regression helpers | assertStatePath |
Package boundary
The Express API under apps/server and the example CLI are application surfaces, not npm framework packages. Install the libraries in your own application, or run the Server from the Hypha repository.