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
The guide link explains concepts and composition. The API link enumerates every exported module, class, function, interface, type, constant and public member generated from TypeScript declarations.
| Package guide | Primary boundary | Typical entry point | Complete API |
|---|---|---|---|
hypha-core | Versioned framework contracts | createFrameworkEvent | modules/symbols |
hypha-storage | Provider-neutral storage profiles | createSQLiteStorageProfile | modules/symbols |
hypha-fsm | Validated FSM topology/runtime | parseFSMProcessSpec | modules/symbols |
hypha-kernel | ReAct reasoning contracts | reactAgentSpecDefinition | modules/symbols |
hypha-harness | Event-first execution and projection | SessionProjector | modules/symbols |
hypha-models | Model providers and routing | ModelRegistry | modules/symbols |
hypha-inference | Normalized inference backend | InferenceManager | modules/symbols |
hypha-memory | Governed scoped memory | memorySpecDefinition | modules/symbols |
hypha-skills | Progressive instruction loading | SkillRegistry | modules/symbols |
hypha-tools | Typed governed tool execution | ToolRegistry | modules/symbols |
hypha-mcp | Governed MCP integration | mcpIntegrationSpecDefinition | modules/symbols |
hypha-domain | Domain Pack compilation | compileDomainPackToHarnessedSystem | modules/symbols |
hypha-adapters-local | Local provider composition | createLocalStorageBackbone | modules/symbols |
hypha-serving-cache | Scoped response cache | ServingCacheManager | modules/symbols |
hypha-testing | Replay/regression helpers | assertStatePath | modules/symbols |
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.