> ## Documentation Index
> Fetch the complete documentation index at: https://docs.heylua.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Glossary

> Every Lua term in one line, with its code or CLI identifier and a link to the page that explains it

One entry per term, alphabetical. The first column is the word the docs use; the third is how it appears in code or on the command line.

*Verified against lua-cli 3.33.0.*

| Term                                                        | Definition                                                                                                                                                                          | Code / CLI                                                                  |
| ----------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
| [activate, deactivate](/concepts/releases-and-versions)     | Turn a primitive on or off without changing versions.                                                                                                                               | `lua mcp activate`, `lua jobs deactivate`, `lua triggers deactivate`        |
| [admin dashboard](/get-started/for-operators)               | The web UI at admin.heylua.ai; its code editor is the Builder.                                                                                                                      | `lua admin`                                                                 |
| [agent](/concepts/agents)                                   | The deployable unit an end user talks to: persona, skills, and the primitives registered on it.                                                                                     | `LuaAgent`, `lua push agent`                                                |
| [agent template](/concepts/agent-templates)                 | A marketplace blueprint of a whole agent that another organization deploys or installs.                                                                                             | `lua marketplace template`                                                  |
| [agent version](/concepts/releases-and-versions)            | A numbered snapshot of every primitive's version, the persona version, and the model; promoting one applies all of it except the persona in one step.                               | `lua version create`, `lua version promote <n>`                             |
| [API key](/concepts/credentials)                            | A personal credential; classes are legacy key, scoped key (`api_<uuid>.<secret>`), and device credential.                                                                           | `lua auth configure --api-key`, `LUA_API_KEY`                               |
| [channel](/concepts/channels)                               | Where end users talk to the agent: WhatsApp, the web widget, email, Slack, Teams, voice, and others.                                                                                | `lua channels`, `Lua.request.channel`, `Channels.send`                      |
| [connection](/concepts/integrations)                        | A stored authorization to one third-party account, created when an integration is connected; a workflow can declare the connections it needs by key.                                | `lua integrations connect`, `--connection <id>`                             |
| [conversation](/reference/sdk/user)                         | The exchange between an end user and the agent.                                                                                                                                     | `User.getChatHistory()`                                                     |
| [deploy](/concepts/releases-and-versions)                   | Make one pushed version of one primitive live in production.                                                                                                                        | `lua deploy <type> --set-version <n>`                                       |
| [desktop app](/get-started/for-operators)                   | The Lua desktop application; its Runs page lists workflow runs, and its Inbox holds the approvals and questions that need a person.                                                 | —                                                                           |
| [device](/concepts/devices)                                 | Hardware or a local machine the agent controls; each device command becomes a tool.                                                                                                 | `defineDevice`, `lua push device`, `lua devices`                            |
| [device trigger](/devices/triggers)                         | An event a device sends to wake the agent.                                                                                                                                          | `defineDeviceTrigger`, `lua push device-trigger`                            |
| [dynamic job](/reference/sdk/jobs)                          | A job created at runtime from a tool, usually for one end user.                                                                                                                     | `Jobs.create`                                                               |
| [end user](/build/identify-users)                           | The human talking to the agent; the developer is always "you".                                                                                                                      | `User.get()`                                                                |
| [environment variable](/concepts/environments)              | A named value your code reads with `env('KEY')`; production values are stored on the platform, local values in `.env`.                                                              | `lua env production -k <KEY> -v <value>`, `lua env sandbox`                 |
| [feature](/concepts/knowledge-and-features)                 | A built-in ability switched on or off per agent, such as Knowledge Search (`rag`) or Web Search.                                                                                    | `lua features enable --feature-name <name>`                                 |
| [governance](/concepts/governance)                          | Rules that block a tool call, hold it for a person's approval, or scan messages for prompt injection; `sdk` mode runs them on the platform, `api` mode asks a server you run.       | `governance` on `LuaAgent`, `lua governance`                                |
| [Inbox](/build/workflows/operate-runs)                      | The desktop app view that collects cards needing a person: approvals, input requests, and notices an agent posts.                                                                   | `User.Inbox.push`                                                           |
| [integration](/concepts/integrations)                       | A third-party SaaS connected through Unified.to; it provisions an MCP server and allows raw calls.                                                                                  | `lua integrations connect --integration <type>`, `Integrations.passthrough` |
| [integration webhook](/integrations/events)                 | An event subscription from a connected SaaS, delivered to a webhook or trigger.                                                                                                     | `lua integrations webhooks`                                                 |
| [job](/concepts/jobs)                                       | A scheduled background task; the schedule is `cron`, `interval`, or `once`.                                                                                                         | `LuaJob`, `lua push job`, `lua jobs`                                        |
| [knowledge](/concepts/knowledge-and-features)               | Documents the agent retrieves from while the `rag` feature is on.                                                                                                                   | `lua resources`, `lua features enable --feature-name rag`                   |
| [marketplace skill](/marketplace/skills)                    | A reusable skill listed on the marketplace.                                                                                                                                         | `lua marketplace skill`                                                     |
| [MCP server](/concepts/mcp-servers)                         | An external MCP server attached to the agent; it has no versions, and a push replaces the record with the same name.                                                                | `LuaMCPServer`, `lua push mcp`, `lua mcp activate`                          |
| [model](/concepts/models)                                   | The LLM the agent runs on. Its `'provider/model'` string is the model code; a per-request chooser function is a model resolver.                                                     | `model`, `modelSettings`, `lua models set --model <code>`                   |
| [organization](/concepts/credentials)                       | The billing and membership unit that owns agents.                                                                                                                                   | `--org-id`, `lua agents`                                                    |
| [persona](/concepts/persona)                                | The instructions the model reads before every conversation; a push creates a numbered persona version that is served from the agent's next message, and promote does not change it. | `persona` on `LuaAgent`, `lua deploy persona`                               |
| [postprocessor](/concepts/processors)                       | A transform applied to every reply after the model.                                                                                                                                 | `PostProcessor`, `postProcessors`, `lua postprocessors`                     |
| [preprocessor](/concepts/processors)                        | A transform or gate applied to every message before the model.                                                                                                                      | `PreProcessor`, `preProcessors`, `lua preprocessors`                        |
| [primitive](/concepts/agents)                               | One of the things you register on `LuaAgent` and push: skill, webhook, trigger, job, workflow, preprocessor, postprocessor, MCP server, device, device trigger, voice.              | `lua push <type>`                                                           |
| [production](/concepts/environments)                        | The environment that serves end users on every channel.                                                                                                                             | `lua env production`, `lua chat -e production`                              |
| [project scaffold](/get-started/project-structure)          | The files `lua init` generates.                                                                                                                                                     | `lua init --with-examples`                                                  |
| [promote](/concepts/releases-and-versions)                  | Make an agent version live for every primitive and the model in one step; also the rollback path for everything except the persona.                                                 | `lua version promote <n>`                                                   |
| [push](/concepts/releases-and-versions)                     | Upload a new version of a primitive to the server; nothing changes for end users, except that a pushed persona is served at once.                                                   | `lua push <type>`                                                           |
| [run](/build/workflows/operate-runs)                        | One execution of a workflow, with a status and a record of every step.                                                                                                              | `lua workflows start`, `lua workflows status <runId>`                       |
| [sandbox](/concepts/environments)                           | The environment where `lua chat` runs your local skills, processors, and persona.                                                                                                   | `lua env sandbox`, `lua chat -e sandbox`                                    |
| [skill](/concepts/skills-and-tools)                         | A named group of tools with a shared prompt `context`.                                                                                                                              | `LuaSkill`, `lua push skill`                                                |
| [skill version](/concepts/releases-and-versions)            | The `x.y.z` version number of one pushed primitive; likewise webhook version, job version.                                                                                          | `--set-version 1.0.5`                                                       |
| [Space](/concepts/spaces)                                   | A dashboard-only supervisor agent that routes a conversation to member agents.                                                                                                      | —                                                                           |
| [step](/concepts/workflows)                                 | A node in a workflow: code step, agent step, approval step, and others.                                                                                                             | `createStep`, `.agentStep()`, `.approval()`                                 |
| [thread](/reference/cli/chat)                               | An isolated conversation scope.                                                                                                                                                     | `lua chat --thread <id>`, `threadId`                                        |
| [tool](/concepts/skills-and-tools)                          | One function the model can call.                                                                                                                                                    | `class implements LuaTool`                                                  |
| [trigger](/concepts/triggers)                               | A declarative paste-anywhere URL that wakes the agent, runs one tool, or starts a workflow.                                                                                         | `defineTrigger`, `lua triggers`                                             |
| [user session](/concepts/credentials)                       | The renewable sign-in the CLI creates from an email code.                                                                                                                           | `lua auth configure --email`, `lua auth sessions`                           |
| [voice](/concepts/voice)                                    | The voice agent configuration for phone, browser, or a LiveKit room; a live call is a voice session.                                                                                | `defineVoice`, `lua voice`, `Voice.call`                                    |
| [webhook](/concepts/webhooks)                               | An HTTP endpoint your code handles, outside any conversation.                                                                                                                       | `LuaWebhook`, `lua push webhook`, `lua webhooks`                            |
| [WhatsApp message template](/build/send-proactive-messages) | A Meta-approved outbound WhatsApp message for sends outside the 24-hour window.                                                                                                     | `Channels.whatsapp.sendTemplate`, `Templates.whatsapp`                      |
| [workflow](/concepts/workflows)                             | A durable multi-step orchestration; one execution is a run.                                                                                                                         | `createWorkflow`, `lua push workflow`, `lua workflows`                      |
| [workspace](/build/workflows/job-tier)                      | A workflow's Job-tier filesystem checkout; never used for an organization.                                                                                                          | `ctx.workspace`, `lua source`                                               |

Terms we don't use, per concept: for an agent, not bot, chatbot, assistant, AI agent, or copilot; for a skill, not plugin, module, capability, or capability module; for a tool, not function, action, command, or capability; for a webhook, not hook, endpoint (as the noun), or callback; for a trigger, not event hook, automation, or agent trigger; for an integration webhook, not integration trigger (a CLI alias only) or connector event; for a job, not cron, scheduled task, scheduler, or timer; for a workflow, not pipeline, flow, automation, or process; for a step, not stage, task, node, or phase; for a preprocessor or postprocessor, not pre-processor, message filter, middleware, or hook; for an MCP server, not MCP-server, mcpserver, or MCP integration; for a device, not IoT device (in headings), gadget, device-trigger (in prose), or sensor event; for a voice, not voice bot, phone agent, IVR, or voice assistant; for the persona, not system prompt (except once on the persona page), instructions, or personality; for the model, not LLM (except once on the models page), AI model, or engine; for a channel, not platform, integration, connector, surface, or medium; for an integration, not connector, app, plugin, or channel; for the sandbox and production, not staging (a CLI alias, documented once on the `lua env` page), dev, prod, or live environment; for push, not upload, publish, sync, save, or commit; for deploy, not release, ship, publish, or activate; for promote, not deploy, publish, release, or activate; for activate and deactivate, not enable and disable (except `lua devices enable`), toggle, or turn on; for an agent version, not snapshot (alone), release, build, or agent snapshot; for a skill version, not build or revision; for an agent template, not marketplace template, template (unqualified), or blueprint; for a marketplace skill, not template, package, or plugin; for the project scaffold, not project template, starter template, the template, or boilerplate; for a WhatsApp message template, not template (unqualified) or WhatsApp template; for an organization, not org, workspace, team, company, account, or tenant; for a Space, not hub agent, router, orchestrator, or organization; for an API key, not token, secret key, access key, personal key, or typed credential (except on the credentials page); for a user session, not login, login session, or OTP session; for a thread, not session, chat session, or context; for a conversation, not chat, session, or dialogue; for an end user, not customer (except in domain examples), visitor, or user; for the admin dashboard, not Lua Admin, console, portal, or dashboard (unqualified). Bare "session" is never used.
