Alpha
Targeting ATProto Spaces proposal work (not a frozen release)
We expect breakage—and plan for it
Flock · atproto Spaces
Flock is an alpha Slack-style workspace where channels and membership live on members’ PDSes. This talk is about why we built it that way and how we stay aligned as Spaces evolves.
Demo: docs/media/bdd-session.mp4 — full UI scenario walkthrough
Part 1
Why
Apps still need a small operator: someone trusted to apply membership changes safely and tell clients when repos change—without holding the messages.
Why now
Alpha
Targeting ATProto Spaces proposal work (not a frozen release)
We expect breakage—and plan for it
68
Browser scenarios exercise the product every CI run
Plus protocol acceptance tests
Open
Lexicons, operator, and tests are in the repo
Feedback welcome
Part 2
How · data flow
Animated packets (loop) show direction; captions stay plain language
Web app
Operator
Admin action · service auth
Operator
Space PDS
Journaled writes · roster / channels
Space PDS
Operator
Wake · repo cursor (no message body)
Web app
Operator
Change feed · long poll
Web app
Space PDS
STAR read · space credential
Operator URL serves XRPC; web talks to member PDSes directly for reads
Privacy assumptions
How · lexicons
packages/protocol/lexicons/new/flock · sorted ascending
How · public API
| Surface | Endpoint | Who calls |
|---|---|---|
| Operator service (OPERATOR_URL) | ||
| procedure | /xrpc/new.flock.operator.execute | Browser (admin) |
| query | /xrpc/new.flock.operator.getOperation | Browser |
| query | /xrpc/new.flock.operator.listInboxWriters | Browser |
| query | /xrpc/new.flock.operator.listStalledOperations | Browser |
| procedure | /xrpc/new.flock.operator.getChanges | Browser (change feed) |
| procedure | /xrpc/new.flock.operator.createWorkspace | Browser |
| procedure | /xrpc/new.flock.operator.startAuthorityFlow | Browser |
| procedure | /xrpc/com.atproto.space.notifyWrite | Space PDS → operator |
| procedure | /xrpc/com.atproto.space.notifySpaceDeleted | Space PDS → operator |
| GET | /.well-known/did.json | Discovery |
| GET | /authority/start · /authority/callback · client-metadata · jwks | Workspace authority OAuth |
| Web app (APP_URL) — no member XRPC on the server | ||
| GET | /oauth/client-metadata.json | Member OAuth (browser only) |
| Member PDS (browser + space credential) | ||
| — | com.atproto.space.* (STAR read/write, credentials) | Browser sync engine |
| — | com.atproto.memberspace.* | Operator journal + browser |
| — | com.atproto.server.getServiceAuth | Service JWT → operator |
How we stay current
Pin
Test
Ship
Active branch: chore/protocol-drift-6747610 (R12 alignment work)
Part 3
Next steps
Next steps
Repository
https://github.com/atproto-sandbox/atprotocol-slack-clone
Quick start: README → playground · Tests: pnpm test:bdd · Developer onboarding (Spaces guide)