koel_agno

Agno backend bridge for koel, the premium Dart/Flutter SDK for the AG-UI protocol. koel_agno adapts an Agno agent backend to koel's typed event stream — message conversion, an auth interceptor, and an error classifier tuned to Agno's wire shape — verified against captured fixtures via the conformance runner.

Getting started

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

Authentication

AgnoAgent's token is optional, and the AgnoAuthInterceptor is default-ON as a harmless convention: stock agno enforces zero auth on its AG-UI route (CORS only — OQ-Agno-Auth resolved against agno==2.6.10), so an open deployment simply ignores the Authorization header. Pass a token only when your deployment adds its own auth middleware (which then returns 401/403, mapped to businessAuth/businessForbidden by AgnoErrorClassifier):

final agent = AgnoAgent(baseURL: Uri.parse('https://my-agno.example'), token: 'xyz');

Documentation

Guides are on the koel docs site — see Connect Agno. 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.

License

MIT © 2026 Si Huynh. See LICENSE.