# 00 — Glossary

Terms used across the documentation. Keiki's vocabulary is kept where it is good; LatAm and
WhatsApp terms are added.

| Term | Meaning |
|---|---|
| **Organization (org)** | The tenant and isolation boundary for an individual, team or business. Owns agents, channels, API keys, secrets, billing, members. |
| **Member / role** | A human user of the dashboard with role `owner`, `admin`, `member` or `viewer`. |
| **Agent** | A configured AI worker for personal, team or business jobs: instructions, model, tools and toggles. Has versions; channels are deployment configuration. |
| **Agent version** | Immutable snapshot of agent config; exactly one is active. |
| **Deployment** | A partner-created agent keyed by the partner's `external_ref` (one per customer of a SaaS). It lives in its own client org, linked to the partner org (ADR-0012). Deployment config (channel credentials, identity webhook, actions webhook) is not versioned with the agent. |
| **Channel** | A messaging surface: `whatsapp`, `instagram`, `messenger`, `telegram`, `sms`, `email`, `voice`, `web`, `api`, `slack`, `teams`. |
| **Channel identity (line)** | One concrete address an agent speaks from: a WhatsApp Business phone number, an Instagram account, a Telegram bot, an email inbox. Keiki calls these "lines" or "identities". |
| **WABA** | WhatsApp Business Account (Meta). Owns phone numbers, templates, quality rating. |
| **Embedded Signup** | Meta's OAuth-like flow (v4) by which a business connects its WABA and phone number to our app. |
| **Tech Provider / Solution Partner** | Meta partner tiers that may onboard other businesses to the WhatsApp Business Platform. We launch through a BSP that holds this status; obtaining our own is a Phase 3+ option. |
| **BSP** | Business Solution Provider (Meta term). Twilio, 360dialog, Infobip, Kapso, etc. |
| **Customer service window** | 24 hours after a contact's last message in which a business may send free-form messages on WhatsApp. Outside it, only templates. |
| **Template message** | A Meta-approved outbound message (utility, marketing, authentication) usable outside the window. |
| **Interactive message** | WhatsApp message with reply buttons (≤3), a list (≤10 rows), a CTA URL button, or a Flow button. |
| **WhatsApp Flow** | A Meta-hosted, encrypted in-chat form defined in JSON; optional data endpoint. |
| **Quality rating** | Meta's Green/Yellow/Red score per number driven by blocks and reports. |
| **Messaging limit (tier)** | Max unique contacts a number may initiate conversations with per 24 h (250 → 1K → 10K → 100K → unlimited). |
| **Contact** | The person interacting with an agent (an individual user, coworker or customer) on a channel. Identified by channel address (`wa_id`, IG-scoped ID, Telegram user id, E.164, email). May have no phone number. |
| **Conversation** | The thread between one contact and one agent on one channel identity. Unit of history, memory thread, steering queue, approvals. |
| **Principal** | Who is speaking, as resolved by the tenant's identity webhook: `userId`, `role`, `scopes`. Permission checks read only these. |
| **Turn** | One run of the agent loop for one conversation, triggered by an inbound batch, a notice, a steer or a test. One trace, one job, one set of credentials. |
| **Steering** | Platform behaviour around bursts: debounce window, max batch, and mid-turn strategy (`interrupt`, `append`, `queue`). |
| **Harness** | Where the turn loop runs: `cloud` (ours, default) or `external` (the tenant's app, via signed async dispatch). |
| **Tool** | A function the model may call: `webhook` (HTTP to tenant), `mcp` (remote MCP server), `code` (sandbox), `builtin` (ours), `capability` (installed manifest). |
| **Tool policy** | `approval`, `requiredScopes`, `argScopes`, `previewTool`, `freshnessFields`, `descriptionArg`, `approvalProof`, `approvalFallback`, `preflight`, `card`. |
| **Governed action** | A persisted record of a tool call that needs approval: `pending → executing → completed | failed | declined | superseded`. |
| **Handoff** | A conversation queued for a human (`waiting → taken → resolved`). Reply = takeover. |
| **Notice** | Text written *for the agent* (not forwarded) that starts a proactive turn. |
| **Alert / Loop** | Scheduled or triggered agent runs (cron, interval, webhook) that broadcast to subscribers or run a task. |
| **Capability** | A versioned JSON manifest that adds tools, prompt, loops, entities and secrets to an agent. Official or third-party. Runtimes: `mcp`, `openapi`, `codemode`, `render-template`, `builtin`. |
| **Memory** | Per-contact durable facts (working memory), message history, semantic recall and observational memory. Scoped `resource = org:contact`, `thread = conversation`. |
| **Trace / span** | One trace per turn; spans for each model call, tool call, retrieval, delivery. |
| **Eval case** | A saved prompt + history + mocked tools + checks, run as a real unbilled turn. |
| **Replay / tape** | A frozen production turn re-run against a proposed prompt to detect regressions. |
| **Signals / mood** | Automatic per-turn classification: mood 0–4, praise, frustration, correction, unsupported claim, task failure. |
| **BYOK** | Bring your own key: tenant-supplied provider credentials for models, memory, browsing, scraping, sandbox, STT. |
| **Credits** | Platform billing unit consumed by model tokens and metered platform tools. |
| **LGPD / LFPDPPP / Ley 1581 / Ley 25.326 / GDPR** | Data-protection laws of Brazil, Mexico, Colombia, Argentina, EU. |
| **EU AI Act Art. 50** | Obligation (in force 2026-08-02) to tell people they are interacting with an AI. |
| **Pix / SPEI / OXXO / PSE / Bizum / MB WAY / Satispay** | Local payment rails in Brazil, Mexico (bank transfer, cash), Colombia, Spain, Portugal, Italy. |
| **es-419** | BCP-47 tag for neutral Latin American Spanish; default for countries without their own variant pack. |
| **Tier A / Tier B** | Launch-footprint depth: Tier A countries get local payment rails, legal review and a language variant pack at GA; Tier B countries are open at GA and promoted afterwards. |
| **Garante / AGCM** | Italy's data-protection authority and competition authority. |
| **AI Providers clause** | Meta's October 2025 WhatsApp Business Solution Terms barring general-purpose AI assistants from the Business API while allowing business-specific customer-service agents. |
