Skip to content

Reference

Server utilities

Nuxt server utilities and helpers for agents, tools, automations, integrations and models.

Nuxt server utilities

Auto-imported in server/.

UtilityDescription
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

HelperPackageGuide
defineAgentTool@nuxtagentic-pro/serverTools
defineAutomation@nuxtagentic-pro/serverAutomations
defineIntegration@nuxtagentic-pro/serverIntegrations
defineFeature, defineRoute@nuxtagentic-pro/serverFeatures
selectDefaultFeatures, defaultFeatures@nuxtagentic-pro/serverFeatures
defineAgenticModel, workspaceColumns, timestamps@nuxtagentic-pro/server/modelsAgentic Models
defineVoidAgentic@nuxtagentic-pro/void/serverConfiguration
defineUiFeature, defaultUiFeatures@nuxtagentic-pro/vueDashboard UI

Nitro hooks

agentic:run:start, agentic:run:finish, agentic:tool:call, agentic:approval:requested and agentic:approval:resolved. See Events.