Reference
Server utilities
Nuxt server utilities and helpers for agents, tools, automations, integrations and models.
Nuxt server utilities
Auto-imported in server/.
| Utility | Description |
|---|---|
useAgentic(event) | Actor-bound services for the request's user and workspace |
useAgenticBindings(event) | { env, context }: the Cloudflare bindings and execution context |
useAgenticAuth(env) | The better-auth instance on the app's D1 database |
useAgenticServer() | The Agentic server: routes, fetch(request, env, context) and services(request, env, context) |
defineNuxtAgentic(config) | The server/agentic.ts configuration; see Configuration |
defineAgentTool, defineAgenticModel, defineAutomation and defineIntegration are also
auto-imported. To read the session yourself:
const { env } = useAgenticBindings(event)
const session = await useAgenticAuth(env).api.getSession({ headers: event.headers })
Definition helpers
| Helper | Package | Guide |
|---|---|---|
defineAgentTool | @nuxtagentic-pro/server | Tools |
defineAutomation | @nuxtagentic-pro/server | Automations |
defineIntegration | @nuxtagentic-pro/server | Integrations |
defineFeature, defineRoute | @nuxtagentic-pro/server | Features |
selectDefaultFeatures, defaultFeatures | @nuxtagentic-pro/server | Features |
defineAgenticModel, workspaceColumns, timestamps | @nuxtagentic-pro/server/models | Agentic Models |
defineVoidAgentic | @nuxtagentic-pro/void/server | Configuration |
defineUiFeature, defaultUiFeatures | @nuxtagentic-pro/vue | Dashboard UI |
Nitro hooks
agentic:run:start, agentic:run:finish, agentic:tool:call, agentic:approval:requested and
agentic:approval:resolved. See Events.