koel_core

Foundation package for koel, the premium Dart/Flutter SDK for the AG-UI protocol. koel_core is pure Dart (no Flutter dependency) and defines the protocol kernel: the sealed AgUiEvent union, the sealed KoelError hierarchy, the four-stage event pipeline, the interceptor chain, the chat-state reducer, and the KoelClient / ChatSession API.

Getting started

// pubspec.yaml:  dart pub add koel_core
import 'package:koel_core/koel_core.dart';

Most apps use the koel meta-package rather than depending on koel_core directly.

Documentation

Guides and concept docs are on the koel docs site — start with Events and The reducer. The API reference is on the pub.dev API tab (dart doc); see the repo-root README for the package map.

Changelog

See CHANGELOG.md.

Credits

Credit to the community ag_ui 0.1.0 package as the genre's first attempt at an AG-UI client for Dart. koel is a clean-slate rewrite with no migration obligation.

License

MIT © 2026 Si Huynh. See LICENSE.