@happyvertical/smrt-education
Preview tenant-aware learning catalog models and services for courses, lessons, learners, submissions, authoring, and group sharing.
What it gives you
Preview tenant-aware learning catalog models and services for courses, lessons, learners, submissions, authoring, and group sharing.
- 01The package is a preview, so its models and services can still change
- 02Courses, ordered sections, lessons, and lesson-owned files in one catalog
- 03CatalogService authorizes each read through a decision the application supplies
- 04Services own learner planning, progress, submissions, course authoring, and course bundle import
- 05Private family material never reaches a learner-facing result
Catalog reads use the caller’s authorization
Catalog objects are scoped to an optional tenant. Applications call CatalogService with an actor-bound decision. The tenant catalog read scope widens only a list to the tenant, its ancestors, and global rows. It never authorizes a get, a write, or a raw query.
Private material stays private
Courses marked personal-use-copy and all answer keys and assessment guidance are private family material. A learner never sees guardian-audience material. A learner bundle never carries a key, and a missing key stays null.
Services own the writes
LearnerService, SubmissionService, LessonWorkService, CourseAuthoringService, and GroupSharingService perform authorization and transactions. Course revisions are append-only. Group tenants never become family ancestors or guardians.
Import and ingestion
CourseBundleImportService reads a bounded bundle and refuses hostile input instead of trimming it. Nothing imports as published. The ingestion entry supports the extract-questions handler for scanned worksheets. The node entry reads Class CrunchLabs downloads from disk.
Package UI
No UI layer to carry
This package stays focused on models, runtime behavior, or tooling. Build its interface with smrt-ui, or use a related domain package that exposes a /svelte entry point.
Intentionally headless
Package previews
No playground module yet
This package does not currently export a ./playground module. Its component names and import path remain available in the Components tab.
Intentionally not registered
Generated interface
REST
The exact route set comes from each model's @smrt({ api }) policy
and the application manifest—not from a second controller definition.
Catalog and learner objects publish no generated REST, CLI, MCP, or AI surface. Applications call the services and decide guardian permissions.
Generated interface
MCP
AI tools are generated from the methods you explicitly include. Their inputs are validated against the same model metadata used by REST and CLI.
Catalog and learner objects publish no generated REST, CLI, MCP, or AI surface. Applications call the services and decide guardian permissions.
Browser-native agent interface
WebMCP
The generated web definitions carry the same tool names, descriptions, and JSON Schema
inputs as MCP. smrt-web registers them with document.modelContext.
Catalog and learner objects publish no generated REST, CLI, MCP, or AI surface. Applications call the services and decide guardian permissions.
Generated interface
CLI
The app CLI turns manifest resources into predictable operator commands while keeping package-specific actions close to their models.
Catalog and learner objects publish no generated REST, CLI, MCP, or AI surface. Applications call the services and decide guardian permissions.