Teams and rooms

Scopes

Cengrid keeps state per scope, not per chat platform.

Scope	Id	Holds
Organisation	org:<id>	Org-wide configuration and capabilities
Team	team:<id>	A group’s capabilities, instructions and model
Person	personal:<principalId>	One person’s DMs, memory, files, keychain view, crons, apps and sandbox
Room	room:<platform>:<ref>	One shared channel, space or web room. It keeps its conversation: members, messages, threads, logs and room policy. Everything else lives in its team.

DMs on every platform are personal scopes. A turn in a room saves its memory, files, crons, apps and shared computer workspace into the room’s team. A room that has not been put in a team saves into itself, and the admin console requires a team for every room it adds.

Teams

A team groups people and rooms so they share capabilities, instructions and a model. Create one with Teams → Create team, giving a name (up to 80 characters) and an optional description (up to 500). The id is derived from the name: 1 to 63 lowercase letters, digits or hyphens starting with a letter or digit.

Membership is derived, not edited directly. A person is in a team when it is their primary team, when they are a member of a room assigned to it, or when they are a team admin. A team’s page has tabs for Members, Capabilities and Files and data, and organisation administrators also see Rooms, Permissions and Instructions and model.

Rooms

A room is a shared conversation space with its own scope.

Platform	How a room is created
Slack	An admin adds the channel under Admin → Rooms → Add room. The bot must already be in the channel.
Google Chat	An admin adds the space the same way, after the app has been added to it.
Web	An admin creates it in Admin → Rooms. A web room has an owner who manages its members.

Slack and Google rooms are configured, not discovered. Until an admin adds a channel, the bot does not serve it. In the admin console every room needs a team: choose Create a new team or Use an existing team when you add it. For Slack, the welcome message and pinned header are posted when the room is configured, not when the bot joins.

1. Invite the bot to the Slack channel, or add the Chat app to the space.
2. Open Admin → Rooms and choose Add room.
3. Pick the platform and the channel or space.
4. Choose a team for the room.

What a turn can reach

A room in a team has no capabilities of its own.

Conversation	Capabilities come from
A room in a team	The organisation and that team
A room outside a team	The organisation and the room
A direct message	The organisation, the person’s primary team and the person

Membership in another room never adds its capabilities. See capabilities overview and manage capabilities.

Note

Conversation logging records what each platform shows Cengrid in a configured room, with per-platform coverage and organisation-level retention. Admins can turn log sync off for a room.