DB · Adapter
neon
via Neon
Serverless Postgres with environment-as-branches. Snapshot via marker.
@openagentry/adapter-db-neon npm → — · Install
Use it
# Install
$ npm install @openagentry/adapter-db-neon
# Or in a workspace registered with the CLI
$ npx agentry init @openagentry/adapter-db-neon — · Default export
Pattern: lazy
The default export is always a frozen DBAdapter
with static category + id. Methods read env on
first call and cache the underlying instance. Missing config produces an
AgentryError at the use-site, not at import.
import default_ from '@openagentry/adapter-db-neon';
// → dbAdapter — category: 'db', id: 'neon' — · Environment
Configuration
| Variable | Notes |
|---|---|
| NEON_API_KEY | Required. |
— · Reported capabilities
What the manifest says
agentry capabilities --json reports these flags from
the package's openagentry.capabilities manifest block.
- engine
- postgres
- envBranches
- true
- snapshot
- marker
— · Failure modes
Error codes
7 stable codes this adapter throws. Each has a one-line resolution.
-
E_NEON_AUTHNEON_API_KEY is missing or unauthorized. -
E_NEON_NOT_FOUNDA Neon project, branch, or database was not found. -
E_NEON_RATE_LIMITEDNeon API rate limit hit. -
E_NEON_HTTPGeneric non-OK HTTP from Neon. -
E_NEON_NETWORKNetwork failure reaching Neon. -
E_NEON_SCHEMAInput failed Zod validation. -
E_NEON_APINeon surfaced an API error.