Plugins

The plugin system lets you react to lifecycle events without modifying engine code. Each hook is a separate Go interface — implement only the events you care about.

Base Interface01

type Extension interface {
    Name() string
}

Lifecycle Hooks02

Request Events

Provider Events

Guardrail Events

Tenant & Key Events

Budget Events

Registering Plugins03

gw := nexus.New(
    nexus.WithExtension(audithook.New(recorder)),
    nexus.WithExtension(observability.NewMetricsExtension()),
    nexus.WithExtension(relayhook.NewWebhook("https://hooks.example.com/nexus")),
)

Built-in Plugins04

• audit_hook — Records lifecycle events for audit trails (Chronicle integration)

• observability — Increments atomic counters for operational metrics

• relay_hook — Forwards events as webhooks to external systems