Repository navigation
feat(circles): people on other servers in your circles, over ActivityPub - #667
Merged
Merged
Conversation
Off until an admin turns on federation and a person makes themselves findable (a handle, a key pair, WebFinger and an actor). Circles take people elsewhere by handle; shares with them go as signed Create Notes from a queue with back-off, undo sends a Delete. The inbox takes a Note only signed with the key kept for someone in one of the person's circles, recent and with a matching digest, as share.received. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012v8sNShSVTXxoPDab62A1L
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Requested by Adeel · project thread
Description
Before: circles held only people on the same Lens, so family members running their own Lens, or on another ActivityPub server, couldn't be in them.
After: once an admin turns on Settings → Security and access → Circles elsewhere (
federation.enabled, off by default) and a person makes themselves findable under Profile → Circles, they get a handle likeadeel@lens.example. Circles can then hold people elsewhere by their handle. Sharing with such a circle sends each of them a signed ActivityPubCreateof aNote(never the item itself, its links or anything in a vault), and what they send lands in the timeline asshare.received, accepted only when signed by the key Lens kept, dated within five minutes, from the signing actor, and from someone in one of your circles.How:
domain/federation.pydoes WebFinger lookups through the existing net guard, HTTP Signatures (rsa-sha256) with per-person keys sealed with the server secret, and a retrying delivery queue;api/federation.pyserves WebFinger, the actor, an empty outbox and the inbox, all 404 while off or for anyone not findable. Inbound text is stripped of HTML and marked as outside text.Motivation and Context
The distributed half of the agent family network the thread asked for (ActivityPub direction); the fifth of the saved circles PRs after #626, #649, #653, #661 and #664.
Types of changes
!in the title)Checklist:
make hookschecks it on commit).docs/accordingly.changelog.d/circles-elsewhere.md.Done questions (AGENTS.md)
/api/v1/circles/elsewhere,remote,add_remote,remove_remote), MCPcircles_elsewhereandsave_circle.federation.enabledandfederation.urlin Settings with defaults; not in the wizard.tests/api/test_federation.py,circles-ui.test.tsx), docs (docs/federation.md) and the generated client (make openapi) updated.Generated by Claude Code