Package Exports

@narrative-os/engine
@narrative-os/engine/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@narrative-os/engine) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@narrative-os/engine

Core narrative engine for AI-powered story generation with persistent memory and autonomous world simulation.

Features

Hierarchical Memory System: Story Bible → Canon → Vector Store → Structured State → Constraint Graph
HNSW Vector Search: Semantic memory retrieval for narrative context
Constraint Graph: Knowledge graph enforcing logical consistency
World Simulation: Autonomous character agents with goals and agendas
Chapter Generation Pipeline: Story Director → Chapter Planner → Writer → Validator

Installation

npm install @narrative-os/engine

Usage

import { createStory, generateChapter } from '@narrative-os/engine';

// Create a new story
const story = await createStory({
  title: "My Adventure",
  premise: "A young hero discovers a hidden world...",
  characters: [...],
  totalChapters: 10
});

// Generate a chapter
const chapter = await generateChapter(story.id);

Architecture

┌─────────────────────────────────────────────────────────────┐
│                    NARRATIVE OS ENGINE                       │
├─────────────────────────────────────────────────────────────┤
│  Story Bible → Canon Store → Vector Store → Structured State │
│                                                              │
│  Chapter Generation:                                         │
│  Story Director → Chapter Planner → Writer → Validator       │
│                                                              │
│  Post-Chapter Update:                                        │
│  Extract Memories → Update State → Update Graph → Validate   │
└─────────────────────────────────────────────────────────────┘

License

MIT