@voyantjs/core

Module system and framework primitives for Voyant. Transport-agnostic — provides the contracts, registry, container, event bus, links, query, workflows, optional plugin bundles, and config shape that every Voyant module and transport adapter builds on.

Install

pnpm add @voyantjs/core

Usage

import { defineModule } from "@voyantjs/core/module"
import { defineLink } from "@voyantjs/core/links"
import { definePlugin } from "@voyantjs/core/plugin"
import { defineVoyantConfig } from "@voyantjs/core/config"
import { createWorkflow, step } from "@voyantjs/core/workflows"

In Voyant, modules, providers, extensions, and workflows are the main runtime primitives. Plugins are optional distribution bundles that package those pieces together for reuse across projects when a broader bundle is helpful.

Exports

| Entry | Description | | --- | --- | | . | Barrel re-exports | | ./module | Module, defineModule | | ./registry | Module registry | | ./container | createContainer dependency container | | ./events | createEventBus in-process event bus | | ./hooks | Lifecycle hook contracts | | ./orchestration | JobRunner interface for background jobs | | ./links | Module Links — defineLink, generateLinkTableSql, LinkService | | ./query | Cross-module reads — queryGraph, createQueryContext | | ./workflows | In-process saga primitive with compensation | | ./plugin | Plugin bundles — definePlugin, registerPlugins | | ./config | VoyantConfig manifest shape + defineVoyantConfig | | ./env | Environment helpers |

License

Apache-2.0