agentic-character

LLM-driven agent intelligence framework for game simulations.

Packages

Package	Description
agent-system	Core framework — AgentSystem class, decide/dialog/cognitive, LLM integration
test-game	Minimal Game Core consumer for validation
tests	Integration tests

Quick Start

pnpm install
pnpm build
pnpm test

Architecture

Game Core (rule-based game logic) registers handlers with Agent System (LLM-driven intelligence). Agent System consumes events, produces decisions and dialog through LLM agent loops.

Game Core                    Agent System
  │                              │
  ├─ register(character) ───────►│
  ├─ register(action) ──────────►│
  ├─ register(world) ───────────►│
  │                              │
  ├─ acceptEvents(id, events) ──►│
  ├─ step() ────────────────────►│
  │◄─ StepResult { decisions,    │
  │     dialogTurns }            │
  │                              │
  ├─ execute actions             │
  ├─ generate events             │
  └─ repeat                      │