aeria uses one word for each thing, verb and state: the same in its
tools, their answers, the web app and these guides.
| Word |
What it is |
| workspace |
what your work belongs to: its members, apps, artifacts, connections, events, billing |
| member |
a person of a workspace: owner or member |
| grant |
an MCP client you allowed for one workspace |
| sign-in |
your signed-in browser on app.aeria.dev; never called a session |
| event |
one tool call, or one line of an exec, kept in order |
| level |
a tool’s in a workspace: allow, ask, deny |
| held |
a call at ask, paused until you allow or deny it |
| slug |
a workspace’s, an app’s, an artifact’s name in hosts: set at creation, never changed |
| Word |
What it is |
| app |
a service a workspace hosts, made from the seed |
| seed |
the app every app starts from |
| session |
an app’s open branch, or an artifact, with its sandbox |
| branch |
an app’s line of work off main: a session |
| preview |
a branch running on its own host, never production |
| production |
an app’s main, running at <app>-<workspace>.aeria.run |
| bundle |
a build’s output: the Worker’s modules and its migrations |
| deployment |
one bundle uploaded as an app’s production |
| promote |
a branch merged into main, its bundle a deployment |
| close |
a branch ended: promoted, or closed (app_branch_close); then purged |
| purge |
a closed branch’s preview, sandbox and snapshots deleted |
| archive |
hidden, nothing deleted |
| restore |
production’s data back to a point in time |
| load |
a backup put into a preview’s database |
| schedule |
an app’s code run at its cron expression |
| namespace |
a group of an app’s callers (its users, grants, tenancy) |
| tenant |
a group of a namespace’s users whose rows are theirs |
| Word |
What it is |
| sandbox |
a session’s container: where its code is written, tested and built |
| exec |
one run of aeria’s steps in a sandbox |
| line |
one line of an exec’s output: an event of its call |
| snapshot |
a sandbox’s whole disk, kept when it stops, restored at its next start |
| repository |
an app’s or an artifact’s git, in Cloudflare Artifacts |
| Word |
What it is |
| artifact |
what your agent makes beyond its answer: a page, a PDF, a sheet, an email, a video |
| kind |
an artifact’s type: page, pdf, email, excel, video |
| version |
an artifact’s kept build, numbered |
| save |
an artifact’s build kept as its next version |
| unarchive |
an artifact found again |
| connection |
a workspace’s link to an outside service |
| operation |
one call of a connection’s or an app’s API, a tool |
| egress |
the Worker that puts a secret in place of its placeholder, toward the secret’s hosts only |
| Word |
What it is |
| plan |
a workspace’s fee, quota, limits and rates |
| quota |
the usage a plan’s fee brings, pooled across the workspace |
| seat |
a member past the first, paying the plan’s fee |
| balance |
a workspace’s prepaid credit |
| top-up |
credit bought with the card |
| reload |
a top-up charged automatically under a set floor |
| spending limit |
what a workspace may spend a month, set by the owner |
| meter |
one kind of usage, metered and priced |
| ledger |
a workspace’s every credit and debit |
| Word |
What it is |
| operator |
one of aeria’s own staff: reviews published apps, takes a host down and reinstates it |
| takedown |
a host no longer served, by an operator; nothing deleted |
| reinstate |
a taken-down host served again |