Modules

The Business Logic Operating System

SMRT packages organized by purpose. Mix and match based on your needs.

Foundation (7 modules)

Essential packages required for any SMRT application.

@happyvertical/smrt-core ORM (SmrtObject/SmrtCollection), @smrt() decorator, code generators (REST/CLI/MCP), DispatchBus, STI@happyvertical/smrt-config Cosmiconfig loader, secret sanitization, SSG export@happyvertical/smrt-cli Developer CLI: smrt db:*, smrt docs:claude, introspection, code generation@happyvertical/smrt-types Shared TypeScript types/enums — zero runtime code@happyvertical/smrt-vitest Test plugin: auto-manifest generation, cross-package class loading, DB isolation@happyvertical/smrt-scanner oxc-parser AST scanner for class/field metadata extraction@happyvertical/smrt-tenancy Multi-tenancy: AsyncLocalStorage context, auto-filtering interceptors, adapters

Agents & Runtime (4 modules)

Agent lifecycle, background jobs, authentication, and identity management.

@happyvertical/smrt-agents Agent lifecycle, DispatchBus inter-agent messaging, interests-based discovery, scheduling@happyvertical/smrt-jobs Background execution: TaskRunner, ScheduleRunner, fluent JobBuilder, withBackgroundJobs()@happyvertical/smrt-users Auth/RBAC: 4-level permission cascade, hierarchical tenants, sessions, SvelteKit hooks@happyvertical/smrt-profiles Identity: multi-auth (Nostr/OIDC/API keys/magic links), relationships, audit logging

Content & Media (7 modules)

Content types, messaging, chat, assets, images, video, and voice.

@happyvertical/smrt-content STI content types (Article/Document/Mirror), thumbnails, asset associations@happyvertical/smrt-messages Multi-channel messaging (Email/Twitter/Slack) as STI hierarchy, credential encryption@happyvertical/smrt-chat Chat rooms (public/private/DM/agent), threads, agent sessions with tool whitelisting@happyvertical/smrt-assets Provider-agnostic asset management, versioning, polymorphic AssetAssociation@happyvertical/smrt-images Image ops: AI categorization, editing, cross-package STI extending Asset@happyvertical/smrt-video Video production: Character/Performer/Scene, ComfyUI workflows, frame-based durations@happyvertical/smrt-voice TTS voice profiles, cloning from samples, word timings for lip-sync

Business (6 modules)

Commerce, products, advertising, affiliates, accounting, and analytics.

@happyvertical/smrt-commerce Customer/Vendor, Contract (5 STI types), Invoice with ledger integration, Fulfillment@happyvertical/smrt-products Product catalog — reference template for triple-consumption (npm/federation/standalone)@happyvertical/smrt-ads Ad delivery: priority waterfall, weighted A/B variations, immutable event tracking@happyvertical/smrt-affiliates Revenue sharing: multi-type partners, multi-tier commissions, payout processing@happyvertical/smrt-ledgers Double-entry accounting, balance enforcement (EPSILON=0.01), journal lifecycle@happyvertical/smrt-analytics GA4/Plausible: properties, data streams, server-side events, AI-powered reports

Domain (9 modules)

Pre-built domain models for events, places, knowledge, social, and more.

@happyvertical/smrt-events Infinite-nesting event hierarchy, series, participant roles/placements@happyvertical/smrt-places Hierarchical places, geocoding via lookupOrCreate(), Haversine proximity search@happyvertical/smrt-facts Knowledge base: semantic dedup (3-zone reconciliation), evolution chains, confidence@happyvertical/smrt-sites Site lifecycle management, agent bindings with priority ordering@happyvertical/smrt-properties Digital properties with hierarchical zones for content/ad placement@happyvertical/smrt-tags Hierarchical tagging: context-scoped slugs, multi-language aliases@happyvertical/smrt-social Social media OAuth (YouTube/Threads/X/Bluesky), post scheduling@happyvertical/smrt-secrets Envelope encryption (AMK to TDEK to secret), key rotation, audit logging@happyvertical/smrt-projects Provider-agnostic project management

Tooling (5 modules)

UI components, dev tools, federation, and project templates.

@happyvertical/smrt-svelte Svelte 5: Provider, browser AI (STT/TTS/LLM) with warm cache, theme system@happyvertical/smrt-dev-mcp Tier 2 dev MCP: generate-smrt-class, introspect-project@happyvertical/smrt-gnode Federation library — stubs only, not implemented@happyvertical/smrt-template-sveltekit Base SvelteKit scaffold with SMRT integration@happyvertical/smrt-template-site-static-json Community news site scaffold with Praeco/Caelus

Installation

# Install core framework
npm install @happyvertical/smrt-core

# Add domain modules as needed
npm install @happyvertical/smrt-profiles
npm install @happyvertical/smrt-events
npm install @happyvertical/smrt-content

SDK Dependencies

SMRT builds on the HappyVertical SDK for foundational infrastructure.

@happyvertical/ai Multi-provider AI client (OpenAI, Anthropic, Google, AWS)
@happyvertical/sql Database operations (SQLite, Postgres, DuckDB)
@happyvertical/files File system operations (local and remote)
@happyvertical/utils ID generation, string manipulation, date handling