Glossary

Space
A shared collaboration unit containing documents, members, and resources.

Workspace
Product-level term for a private collaboration group; currently modeled by spaces and their associated content, members, and permissions.

Topic
A node in the space tree. Can contain content and sub-topics.

Document
The editable content attached to a topic.

Page
The main navigable note or document unit inside a workspace.

Blob
An attachment (PDF, image, etc.), content-addressed by hash.

Daemon
The local backend handling networking, storage, and permissions. On desktop, it runs in-process inside the Tauri src-tauri host (via the desktop-daemon crate) — no separate process.

soma-daemon
The desktop peer/daemon library crate (libp2p peer + storage). Embedded by the Tauri host (desktop-daemon); no standalone binary.

soma-agentd
The desktop agent library crate (Yjs drift resolver and helpers). Embedded by the Tauri host (desktop-agent); no standalone binary.

somad
The unified server binary. Subcommands bot, relay, rendezvous, bff, and all (TOML-composed multi-mode) replace the former per-service binaries.

• somad bot: server peer/bot (libp2p peer + Axum control plane + metrics).
• somad relay: libp2p Circuit Relay + Axum + metrics.
• somad rendezvous: libp2p Rendezvous discovery + Axum + metrics.
• somad bff: LLM BFF (Axum + metrics; no libp2p).

PeerId
Cryptographic identity of a device.

Capability
A signed token granting permissions in a space.

Model Feature Hint
Local desktop metadata describing whether an AI model is suitable for chat, embedding, tool use, or image work. These hints do not grant any space permissions.

MembershipCapability
Grants a peer access to a space.

Role
The human-facing access level inside a space, such as Owner, Editor, Viewer, Member, or Bot.

IssuerCapability
Delegates authority from an owner to a bot or trusted member.

Bot
A non-human space member that can cache content, serve content, organize resources, or run approved automation depending on its granted capabilities.

Delegated Approver
A peer that has been explicitly delegated authority to approve memberships for a space. A delegated approver may be a bot, but bot membership alone does not grant this authority.

Relay
A connectivity service that forwards encrypted traffic.

Rendezvous
A discovery service helping peers find each other.

Mailbox
A bot-backed queue for delivering approvals asynchronously.

Tapia
Typing-practice surface (short passages, generated drills, and session feedback) planned to live at the /practice route inside the Soma desktop app. The /practice route is not yet wired in the Tauri app; the migration is a tracked follow-up.

Soma
The main structured note-taking and workspace application in the platform.