-
released this
2026-09-11 15:52:00 +00:00 | 68 commits to main since this releaseNextcraft v0.1.3 — v0.2 Phase 2
The shared framework all six AI tutor agents build on.
Delivered (REQ-2-004)
- BaseAgent ABC — system_prompt / build_messages / stream_reply / structured_reply; default provider delegation
- Session store — protocol + in-memory implementation: asyncio.Lock-guarded, 20-message rolling window, 500-cap LRU eviction, agent-scoped sessions (DB-migration-ready)
- Agent registry — central registration, duplicate/unknown error paths
- Structured output defense — 4 layers: response_format with auto-degrade, prompt-embedded schema, fence-strip/first-balanced-object parse, single bounded retry
- Prompt library — six versioned modules with learner-context renderers
- Learner context corpus — pydantic-typed, IDs string-identical to the TS mock-data layer
- Chat endpoint session wiring — persisted turn history, windowed replay, assistant-turn persistence
Quality: 61/61 tests green, ruff clean, module boundaries verified (agents/ never imports api/).
Next
Phase 3: Coach + Tutor agents — full LLM implementations with agent routing.
Downloads