Skip to content
Starlings

Glossary

What each word means in Starlings. Each term lists the document that decided it.

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
guestvisitor
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 askdecision 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
knockask 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
HistoryInteractions
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
MessagesDM
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
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 capturenotepad 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
Pictureavatar
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
WaveRing
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
Unavailablednd
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 planethe 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