Repository navigation
feat(feeds): private RSS and podcast feeds with API and MCP - #534
Merged
Merged
Conversation
A namespace publishes what's in it as an RSS or iTunes podcast feed at a tokenized address that feed readers and podcast apps follow: resources, podcast episodes (their audio as enclosures, with byte ranges), timeline activities and text. Editors make feeds and add to them through the API (/api/v1/feeds) and the MCP tools list_feeds, create_feed and publish_to_feed. What a feed lists is bounded by who reads its namespace and never a vault; the token is found by its hash, rotated on demand, and the feed asks directories and crawlers to keep out. Threat model: P-FEEDS. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01CDEiKGoyQX8Vmnv9bi5JpD
Keeps both changelog entries and both MCP docs changes, the threat model's same-commit prose_version, and the OpenAPI client regenerated with make openapi. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01CDEiKGoyQX8Vmnv9bi5JpD
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01CDEiKGoyQX8Vmnv9bi5JpD
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01CDEiKGoyQX8Vmnv9bi5JpD
The changelog entry moves to the end of Unreleased, so pull requests adding at the top no longer conflict with it. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01CDEiKGoyQX8Vmnv9bi5JpD
This was referenced Oct 18, 2026
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.
Description
Before: nothing in Lens could be followed from a feed reader or a podcast app; a podcast episode was listened to in the web app only, and the timeline was read there too.
After: an editor makes a feed for a namespace, as RSS or as a podcast feed with Apple Podcasts' tags, and adds resources, podcast episodes, timeline activities and text to it. The feed has a private address (
/api/v1/feeds/public/lfd_…) that any feed reader or podcast app follows; an episode's audio is its enclosure, served with byte ranges andHEAD. A feed lists only what the readers of its namespace could already read, never a vault's, and its address can be rotated; readers get304 Not Modifiedwhen nothing changed, and the feed asks directories and crawlers to keep out.This is the first of three pull requests for the ask: next come graph workflow output nodes (pick assets or timeline activities, publish them to a feed, make an episode about them) that routines run, then the Feeds page and the canvas nodes in the web app.
docs/feeds.mdsays so (status: in progress).How:
domain/syndication.pyholds feeds and their items (tablesfeedandfeed_item; the token is hashed for lookup and sealed so the namespace's readers see the address again) and renders RSS 2.0 with the iTunes and podcastindex namespaces;routes/feeds.pyis the API (ETag/304,X-Robots-Tag,Referrer-Policy: no-referrer); the MCP tools arelist_feeds,create_feedandpublish_to_feed. The threat model gains the public entry point, the output row and P-FEEDS.Motivation and Context
Adeel's ask in the project: RSS and iTunes podcast endpoints from routines, so a routine can pick part of the graph or all of it and publish a podcast, or timeline events, through a feed. This PR is the feeds themselves; the routine nodes build on it.
Screenshots (if appropriate):
n/a (API only; the web page comes in the third PR)
Steps to reproduce (if appropriate):
POST /api/v1/feeds {"namespace": "...", "title": "...", "kind": "podcast"}, thenPOST /api/v1/feeds/{id}/items {"recordings": [...]}and open the feed'surlin a podcast app.Types of changes
!in the title)Checklist:
make hookschecks it on commit).tests/api/test_feeds.py, 5 tests;test_mcp.pywrite-tool list).docs/accordingly (docs/feeds.md,docs/mcp.md,docs/requirements.md, README).## UnreleasedinCHANGELOG.md.Done questions (AGENTS.md)
/api/v1/feedsand the MCP toolslist_feeds,create_feed,publish_to_feed..envor step; the tables come with the schema.rss,en, 50 items, author Lens); the web page is the third PR.itunes:block,podcast:locked,X-Robots-Tag,Referrer-Policy: no-referrer; text double-escaped. Threat model: entry point, output row, P-FEEDS.DEFINE ... IF NOT EXISTS); no change to stored data.make openapi).link rel=self, the iTunes and podcastindex namespaces; stdlib only, MIT kept.docs/feeds.md.podcasts._readers/_vault/target's rule for where things may go,events.get_many/visible,recording_routes.serve_audio,settings.seal,deps.web_origin.Generated by Claude Code