@adonis-agora · libraries for AdonisJS
The AdonisJS ecosystem, in assembly.
In the old cities, the agora was the square where everyone gathered — to trade, to argue, to decide. This one gathers 13 plug-n-play, fully-configurable libraries for AdonisJS. Bring one to your app, or convene them all — they share one context, one diagnostics bus, one console.
Get going fast
Plug-n-play
node ace add @adonis-agora/<lib> and you're running with opinionated, typed defaults. Conventions over configuration, wired through the AdonisJS provider — shipping in minutes, not a config marathon.
Tune everything
Configurable to the core
Swap stores, transports, adapters and validators at will. Every seam is a documented public API, so the easy path and the deep path are the same path.
The assembly
Everyone in the agora
Each library stands on its own and documents itself. Step up to any one and follow it in.
Context
@adonis-agora/contextAmbient request/tenant/correlation context that crosses HTTP, queue, durable and ace boundaries — not just the HTTP lifecycle.
Diagnostics
@adonis-agora/diagnosticsA zero-dependency diagnostics bus over node:diagnostics_channel — emit once, observe anywhere, with an OpenTelemetry auto-bridge.
Resilience
@adonis-agora/resilienceComposable timeout, retry, circuit-breaker and failover policies — with a pluggable, distributed breaker store (Lucid, Redis).
Durable
@adonis-agora/durableDurable, resumable, cross-process workflows built on @adonisjs/queue — steps, signals, sagas, leases, DLQ, cron. Resumable by design.
Telescope
@adonis-agora/telescopeA Telescope-style observability console — watchers, request correlation, pluggable storage, headless API + an extensible dashboard.
Authz
@adonis-agora/authzDB-backed roles & permissions that feed AdonisJS Bouncer — wildcard grants, multi-tenancy, a Lucid store and ace commands. Integrates, never replaces.
Collaboration
@adonis-agora/collaborationCollaborative editing (CRDT) for AdonisJS — Yjs/Automerge/edge engines, Redis presence, version control, anchored comments, codegen and React client hooks.
Media
@adonis-agora/mediaA media library for AdonisJS — owner collections, image conversions (eager/lazy), and column attachments, all on top of @adonisjs/drive. The spatie media-library feel.
Filter
@adonis-agora/filterA typed query-param filter language for Lucid — Spatie/JSON:API input, operators and defineFilter classes, offset & cursor pagination, relations via whereHas, full-text (tsvector) and vector-similarity search, plus a type-safe client builder with codegen.
Payments
@adonis-agora/paymentsMulti-gateway payments and Cashier-style billing for AdonisJS — 18 gateways behind one driver contract, from Pix to cards to merchant-of-record, with invoice (NFe/NFSe) emission, method routing and webhook-driven business logic.
Agent
@adonis-agora/agentA governed, durable-ready AI agent for AdonisJS — streaming chat, tool-calling, fail-closed authorization, human-in-the-loop approvals, quota/cost accounting and multi-agent delegation. One loop, two runners.
AuthKit
@adonis-agora/authkit-serverA full OIDC/OAuth2 Authorization Server for AdonisJS — MFA, passwordless, device flow, DPoP, admin & account consoles, plus an OIDC client adapter and React ergonomics.
Sail
@adonis-agora/sailDocker-powered local dev services for AdonisJS — per-worktree isolated containers, deterministic shifted ports, service shells, tunnels, and agent-friendly JSON output.