# Glossary

> What each word means in Starlings, with its source.

- **owner**: An authenticated member of the workspace, on one of its identity domains, who hosts from the Mac or iOS app. Not a role a guest can hold. [docs/PRIVACY.md]
- **host**: The one device that runs a meeting: it admits guests, renews the lease and runs the recognizer. Another device of the same member joins as a companion with its microphone off. Also the product mode for running a room from a native client. Not the Google identity check; that is the owner. Called "the chair" until 5.8.9. [docs/SURFACES.md, docs/TRANSCRIPTION.md, docs/IOS_HOST.md]
- **guest** (visitor): Anyone who is not the owner in a room: joining from a browser, Mac Join or iOS. No account. Name and email required; notes consent optional. [docs/PRIVACY.md, docs/SURFACES.md]
- **guest thread**: A subject's one thread shared by members and the guests a `manage` holder granted on it (`kind = guest`). The subject's own Talk stays members only. Guests reach it through a link: read, or read and post text. [docs/ACCESS.md, docs/PRIVACY.md]
- **peer**: Another member of the workspace, in presence copy and `GET /api/peers`. Not "user", not "contact" (that is Core). [docs/SURFACES.md]
- **agent**: A non-human peer on the Team roster with its own runtime. Messageable, never waved or called; takes cards by hand-off. [docs/AGENTS_SURFACE.md]
- **decision ask** (decision queue): A question an agent files with `ask_decision`: options, a recommendation and a default-by day. It heads INBOX on every client; the answer is recorded as a decision on the subject. Shipped. It never holds an action and never applies the recommendation. [docs/AGENTS_SURFACE.md, docs/help/howto/answer-a-decision.md]
- **action approval**: A held agent action (send, post, spend, delete) that runs only after a person confirms it. Not built yet. Never call a decision ask an approval. [docs/AGENTS_SURFACE.md]
- **room**: The permanent slug and permalink, `/room/<slug>`. Not the live session. [docs/SURFACES.md]
- **meeting**: The live session with a `meeting_id`. Chrome says meeting once media is up; permalinks say room. [docs/SURFACES.md]
- **the internal room** (/room/team): The one room whose audience is the whole workspace, addressed `/room/team`. Membership is the admission: no waiting room, no booking door. Written as the address, never "the team room". [docs/adr/0001-internal-room.md]
- **waiting room**: The guest-facing admission surface. Every guest- and host-facing string says waiting room. [docs/SURFACES.md]
- **lobby**: The same queue on the wire and in `starlings`: `LobbyStatus`, the join-request routes. Never renamed casually. [docs/SURFACES.md]
- **knock** (ask to join): What a guest does at a room's door. Answered by admitting. Not a colleague gesture. [docs/SURFACES.md]
- **prejoin**: The camera and microphone check before a knock or a go-live. Not "preflight". [docs/SURFACES.md]
- **launch**: The owner's idle home on the Mac: waiting room list, upcoming, Start room. [docs/SURFACES.md]
- **stage**: The live video grid. [docs/SURFACES.md]
- **surface**: What the person is looking at, a main page: Home, Calendar, Work, Team, Docs, and the guest flow. Each has a reference page under `docs/help/surfaces/`. [docs/SURFACES.md, scripts/docs-frontmatter.mjs]
- **Home**: Today: the clock, the modules in your order, your room. ⌘1. [docs/SURFACES.md]
- **Work**: The subject surface: projects, and leads, partners and events where their work modules are on, with tasks, issues, documents and Talk. ⌘3. [docs/SURFACES.md, docs/WORK.md, docs/WORK_MODEL.md]
- **Team**: The people surface: who is around, and reaching them. ⌘4. Not the meeting's People panel. [docs/SURFACES.md]
- **Docs**: The fifth surface: the whole corpus, read and written from Starlings. ⌘5. Documents on a subject are the contextual slice. [docs/SURFACES.md, docs/DOCS.md]
- **Mine**: Everything assigned to you across every subject. Inside Work, never a surface of its own. [docs/SURFACES.md]
- **INBOX**: What needs you, in Work; each row leaves when resolved. [docs/SURFACES.md]
- **Sales**: The work module for leads: a section inside Work, not a tab. A workspace admin turns it on; each person can hide it. [docs/SURFACES.md, docs/WORK_MODEL.md]
- **work module**: A set of record types a workspace admin turns on in Admin: Sales, Partners, Events, Support, and later the commercial ones. Always two words; a Home module is a card. [docs/WORK_MODEL.md]
- **store**: Where a workspace keeps its records: Envisioning Core or its own D1. `WORK_STORE`, set at deploy, not in Admin. [docs/WORKSPACE_STORE.md, docs/WORK_MODEL.md]
- **Core**: Envisioning's store, the CRM and CMS behind `CORE_API_ORIGIN`, and nothing else. Never a word in the UI: the door to it is **Other records**. [docs/MEETING_LOG.md, docs/CORE_REGISTRY.md]
- **Settings**: App preferences. ⌘, on the Mac, the gear elsewhere. Not a surface. Qualify "in-meeting Settings" when you mean that. [docs/SURFACES.md]
- **subject**: One project, event, lead or organization: the object everything in Work hangs off. A channel is one view of a subject. `partner` folds into `organization` (ADR 0006). [docs/SURFACES.md, docs/CHANNELS.md, docs/adr/0006-organization-subject.md]
- **client**: A relationship, not a kind: an organization with an active project or license. Read from the records; no flag. Never "customer". [docs/adr/0006-organization-subject.md, docs/SURFACES.md]
- **support request**: A card on an organization, made from a line in its guest thread. Its state is `WorkStage`. Not "ticket". Not built. [docs/SUPPORT.md]
- **intake**: The one members-only subject per workspace for support requests from people with no organization, one guest thread per visitor. Not built. [docs/SUPPORT.md]
- **public door**: A workspace page for people with no account, on its public host: join a room, guest thread, Book a time, support, email in. One registry; Admin lists each with Copy. [docs/SUPPORT.md]
- **Subject Overview**: A subject's landing state: Talk beside Tasks / Issues / Documents / History. Not Work's global Overview. [docs/SURFACES.md]
- **Talk**: The one conversation on a subject. [docs/SURFACES.md, docs/CHANNELS.md]
- **History** (Interactions): A subject's pane merging Core interactions with its event trail, by time. The type `CrmInteraction` and web's `pane=interactions` keep the old name. [docs/SURFACES.md, docs/TIMELINE.md]
- **thread**: One conversation. The parent is polymorphic: none for a DM, a subject for Talk. [docs/SURFACES.md, docs/CHANNELS.md]
- **Messages** (DM): Direct messages between members, reached through a person in Team. Not "chat". [docs/SURFACES.md]
- **Groups**: Team's rail block: Everyone pinned, then the private groups, newest message first. A group is a DM with more than one other person; the people are its name. [docs/SURFACES.md]
- **Chat**: The message panel inside a meeting. Not a destination. [docs/SURFACES.md]
- **Search** (⌘K, the palette): One box that finds anything and jumps anywhere. Every per-surface field is the same search with a fixed scope. [docs/SURFACES.md, fixtures/search-rows.json]
- **card**: A task or an issue on the board: the anchor every agent turn names. Stored in Core or GitHub, never in Starlings. [docs/BOARD.md]
- **artifact**: The finished meeting record, transcript segments plus notes, as delivered to the control plane and to consenting recipients. [docs/TRANSCRIPTION.md, docs/MEETING_LOG.md]
- **the outbox**: `MeetingArtifactOutbox`, one actor shared by the Mac and iOS clients: idempotent by segment UUID, crash-safe, text only. [docs/TRANSCRIPTION.md]
- **ambient capture** (notepad mode): Transcribing a call Starlings does not host: local audio, local STT, the same outbox and artifact path. No bot in the foreign call. [docs/AMBIENT_CAPTURE.md]
- **capability**: One row of `packages/contracts/src/capabilities.ts`: what Starlings does, where it works, and how an agent reaches it: its doors, human only, built in, or a planned door. Not the Worker's role capabilities. [packages/contracts/src/capabilities.ts, docs/DOCUMENTATION.md]
- **Picture** (avatar): A member's own uploaded face. Initials are what a person without one looks like. The wire keeps `avatar`. [docs/SURFACES.md]
- **Message**: Asks for nothing now; it waits in a thread. [docs/SURFACES.md]
- **Wave** (Ring): A nudge from Team: one chime on a running client, gone in 45 seconds, no claim anyone was reached. Was Ring until 1.6.0; the wire keeps `/api/peers/ring`. [docs/SURFACES.md, docs/PRESENCE.md]
- **Call**: Into a colleague's room: a knock if a meeting runs, an ask (Open room / Not now) if they are only available. A room opened this way does not transcribe. [docs/SURFACES.md]
- **Hand off**: Giving a card to an agent: a message to the agent carrying the card. Nothing new on the wire. [docs/SURFACES.md, docs/BOARD.md]
- **Welcome**: The room noticing you arrive: a chime and a ring on your own tile. Not a gesture; nothing sends it. [docs/SURFACES.md]
- **intent**: What a person says about themselves: Available, Focused. A second axis beside the evidence ladder, never a seventh status. [docs/SURFACES.md, docs/PRESENCE.md]
- **Unavailable** (dnd): A self-set closed door, always with an end. `dnd` on the wire. [docs/SURFACES.md]
- **WorkStage**: The one stage vocabulary, `queued / doing / review / blocked / done / dropped`, computed from the row and never stored. Pinned by `fixtures/work-items.json`; change the fixture first. [docs/BOARD.md, fixtures/work-items.json]
- **WorkSection**: The date-section vocabulary beside `WorkStage`. Answers when, not where in the pipeline. [docs/BOARD.md]
- **phase**: `MeetingPhase`, the connection lifecycle: setup, connecting, connected, ended, failed. Not a page. [docs/SURFACES.md]
- **the lease**: The owner device's proof of presence that the control plane gates admission and token exchange on. [docs/SECURITY.md]
- **control plane** (the Worker): The Cloudflare Workers, Durable Objects, Queues and D1 side. Holds room state, consent, transcript text, summaries. Never media. [docs/PRIVACY.md]
- **the factory**: The automation that acts on `agent:*` labels on GitHub issues and opens draft PRs. [docs/BOARD.md]
- **the board**: A projection: Core tasks and GitHub issues read through `WorkStage`. No Starlings-side table holds a card or a column. People see it one project at a time, on the project's Board pane. [docs/BOARD.md]
- **the act record**: Who acted, under whose authority, on what, and how it went: one row per act in `mcp_calls` and `admin_audit`. Never aggregated. Not a status, and never written as "the ledger". [docs/LEDGER.md, docs/MCP.md]
- **the account ledger**: What the organization used: meetings held and the funnel around them, aggregated for Admin. `meetings_ledger` and `usage_events`. Always qualified, because two other things are called a ledger. [docs/LEDGER.md, docs/ADMIN.md]
- **MCP** (/mcp, Connected agents): The door a member's Claude uses to read and write Starlings. OAuth pairing on `/connect`; every call recorded. [docs/MCP.md]
- **starlings CLI**: The Mac CLI over a local socket: `status`, `devices`, `host`, `join`, `lobby`. Speaks wire vocabulary. [docs/OPERATIONS.md, CLI/StarlingsCLI.swift]

---

Canonical page: https://starlingshq.com/help/glossary
