@dxos/plugin-magazine 0.10.0 → 0.11.0

package/dist/lib/MagazinePlugin.mjs

@@ -0,0 +1,36 @@
+import { ActivationEvent, Plugin } from "@dxos/app-framework";
+import { StateMap, TagIndex } from "@dxos/schema";
+import { Instructions } from "@dxos/compute";
+import { meta } from "#meta";
+import { AppActivationEvents, AppPlugin } from "@dxos/app-toolkit";
+import { AttentionEvents } from "@dxos/plugin-attention";
+import { AppGraphBuilder, CreateObject, OperationHandler, ReactSurface, RoutineTemplates, SkillDefinition } from "#capabilities";
+import { translations } from "#translations";
+import { Magazine, Subscription } from "#types";
+//#endregion
+//#region src/MagazinePlugin.tsx
+var MagazinePlugin = Plugin.define(meta).pipe(AppPlugin.addAppGraphModule({
+	activatesOn: ActivationEvent.allOf(AppActivationEvents.SetupAppGraph, AttentionEvents.AttentionReady),
+	activate: AppGraphBuilder
+}), AppPlugin.addCreateObjectModule({ activate: CreateObject }), AppPlugin.addOperationHandlerModule({ activate: OperationHandler }), AppPlugin.addPluginAssetModule({ asset: {
+	pluginId: meta.profile.key,
+	path: "PLUGIN.mdl",
+	content: "---\nid: org.dxos.plugin.magazine\nname: MagazinePlugin\nversion: 0.2.0\n---\n\nA Composer plugin for syndicated content. Today it supports RSS and ATproto\nFeeds whose Posts are synced into the space as ECHO objects. This revision\nadds **Magazines** — agent-curated collections of articles drawn from one or\nmore Feeds and displayed as a Masonry grid. The user describes in natural\nlanguage what content a Magazine should gather; pressing *Curate* triggers\nfeed sync followed by an agent that selects matching articles, fetches their\ntext and hero images, and appends them to the Magazine.\n\nThe design also scaffolds (schema-only) a future tagging feature in which the\nagent assigns tags to curated Posts to enable navigation, filtering, and\nfeed-discovery flows.\n\n## Extensions\n\nThe following extension dialects are used in this document.\n\n| Term        | URI                            |\n|-------------|--------------------------------|\n| `type`      | `org.dxos.mdl.type@1.0`        |\n| `feat`      | `org.dxos.mdl.feat@1.0`        |\n| `test`      | `org.dxos.mdl.test@1.0`        |\n| `component` | `org.dxos.mdl.component@1.0`   |\n| `op`        | `org.dxos.mdl.op@1.0`          |\n| `service`   | `org.dxos.mdl.service@1.0`     |\n\n## Types\n\n```mdl\ntype FeedType\n  literals: atproto | rss\n```\n\n```mdl\ntype Feed\n  desc: >\n    A subscription source. Existing type — documented here for context.\n    SyncFeed pulls Posts from the URL into the space.\n  fields:\n    name?: string\n    url?: string\n    type?: FeedType\n    description?: string\n    link?: string\n    iconUrl?: string\n    cursor?: string                 # sync state\n    feed?: Ref<Queue>               # backing ECHO feed\n```\n\n```mdl\ntype Post\n  desc: >\n    An individual syndicated article. Existing fields are unchanged.\n    This revision adds four optional fields populated by the Magazine\n    curation flow. All additions are optional — existing Posts remain valid.\n  fields:\n    title?: string\n    link?: string                   # URL of the original article\n    description?: string            # feed-provided summary (as-is)\n    author?: string\n    published?: string              # ISO 8601 publication date\n    guid?: string                   # feed-provided unique id\n\n    # --- Additions ---\n    snippet?: string                # short description-derived preview (~200 chars) for tiles\n    content?: string                # full article body plain text, populated on first open\n    imageUrl?: string               # hero image URL extracted from the article page\n    readAt?: string                 # ISO 8601; presence = read, absence = unread\n    tags?: string[]                 # agent-assigned tags (future tagging feature; always [] today)\n```\n\n```mdl\ntype Magazine\n  desc: >\n    An agent-curated collection of articles drawn from one or more Feeds.\n    Curation is driven by a Routine (see MagazineSkill): the Routine's\n    editorial instructions describe what content this Magazine should gather,\n    and it references the MagazineSkill (the HOW — tools and output\n    contract). The Routine is created lazily on first curation, its\n    instructions seeded with the default editorial methodology and the user's\n    `topic`. The agent selects matching Posts from the referenced Feeds,\n    enriches them with snippet and hero image, and their refs are appended to\n    `posts`.\n  fields:\n    name?: string\n    feeds: Ref<Feed>[]              # Feeds to pull from\n    topic?: string                  # create-dialog editorial seed; woven into the Routine's instructions on first curate\n    routine?: Ref<Routine>          # editorial Routine (lazy; created by the curate op); not rendered as form input\n    posts: Ref<Post>[]              # curated Post refs (insertion order; UI displays newest-last reversed)\n  annotations:\n    icon: ph--book-open-text--regular\n    hue: indigo\n    label: name\n  note: >\n    The Routine is added to its own `objects` (context) so the agent sees the\n    Magazine as bound context, not only the candidate JSON `input`.\n```\n\n## Components\n\n```mdl\ncomponent MagazineArticle\n  desc: >\n    Article surface bound to a Magazine object. Shows curated articles in a\n    Masonry grid and offers a Curate button that triggers feed sync plus\n    agent curation.\n  props:\n    magazine: Magazine\n  state:\n    running: boolean                # Curate flow in progress\n    phase?: 'syncing' | 'curating'  # shown as button tooltip while running\n  slots:\n    header?: ReactNode\n  actions:\n    curate()                        # run syncFeeds → invoke CurateMagazine\n    openPost(post: Post)            # sets post.readAt if unset; dispatches useShowItem (plugin-deck)\n  emits:\n    onCurateComplete(added: number)\n  layout: |\n    ┌─────────────────────────────────────────────┐\n    │ [header slot]                 [✨ Curate]   │\n    ├─────────────────────────────────────────────┤\n    │ ┌─────┐ ┌─────┐ ┌─────┐                     │\n    │ │tile │ │tile │ │tile │   (Masonry grid)    │\n    │ └─────┘ └─────┘ └─────┘                     │\n    │ ┌─────┐ ┌─────┐                             │\n    │ │tile │ │tile │                             │\n    │ └─────┘ └─────┘                             │\n    └─────────────────────────────────────────────┘\n    PostArticle is rendered by the host layout (complementary drawer,\n    sibling plank, or deck companion) — not composed inline.\n```\n\n```mdl\ncomponent MagazineTile\n  desc: >\n    Single masonry cell rendering a curated Post. Dimmed when post.readAt is set.\n    Click opens the ArticleReader. Tags row appears only when tags.length > 0.\n  props:\n    post: Post\n    feed: Feed                      # resolved parent feed for name/icon\n  emits:\n    onOpen(post: Post)\n  layout: |\n    ┌─────────────────────────┐\n    │ [hero image if present] │\n    ├─────────────────────────┤\n    │ Title (2-line clamp)    │\n    │ Snippet (3-line clamp)  │\n    │ ─────────────────────── │\n    │ Feed · Author · Date    │\n    │ [#tag] [#tag]           │   (only when tags.length > 0)\n    └─────────────────────────┘\n```\n\n```mdl\ncomponent PostArticle\n  desc: >\n    Independent article surface for a single Post. Registered as a React\n    surface matching `object(Article, Subscription.Post)` so it can render\n    in any article/companion context — the complementary sidebar in\n    'simple' mode, a sibling plank in 'multi' mode, or the deck companion\n    in the default 'deck' mode.\n\n    Panel-based layout with a toolbar; the \"Open original\" link lives in\n    the toolbar so it's always accessible. post.readAt is set by the\n    master (MagazineArticle) when the tile is opened, not by PostArticle.\n  props:\n    post: Post                      # via Surface data.subject\n  layout: |\n    ┌───────────────────────────────────────┐\n    │ Title                 [Open original] │  ← toolbar\n    ├───────────────────────────────────────┤\n    │ Author · Date                         │\n    │ [hero image]                          │\n    │ Snippet                               │\n    └───────────────────────────────────────┘\n```\n\n## Services\n\n```mdl\nservice MagazineSkill\n  desc: |\n    Agent skill referenced by each Magazine's Routine. Registered as a\n    SkillDefinition capability. The skill instructions are limited to\n    HOW to operate: how to call the FetchArticleContent tool and the\n    completeJob output contract. The editorial methodology (what to select,\n    dedup, snippet style, hero-image choice) and the magazine's topic live on\n    the Routine's instructions, not here.\n  key: org.dxos.skill.magazine\n  ops:\n    # Agent-facing tools exposed by the skill:\n    # - FetchArticleContent\n    # (completeJob is provided by the agent runtime; SyncFeed / CurateMagazine /\n    #  ClearMagazine / LoadPostContent are orchestration/UI, not agent tools.)\n  note: >\n    The curate op resolves this skill from the registry and references it\n    from the Magazine's Routine. The agent reads candidate summaries from the\n    `input`, MAY call FetchArticleContent to read full text, then calls\n    completeJob with the structured selection.\n```\n\n## Operations\n\n```mdl\nop SyncFeed\n  desc: Existing operation. Pulls new Posts from a Feed's source URL.\n  input:\n    feedId: DXN\n  output: number                   # number of Posts added\n  effects: [http, echo:write]\n  note: Documented here for context; unchanged by this revision.\n```\n\n```mdl\nop ListCandidatePosts\n  desc: >\n    Returns lightweight summaries of Posts from the Magazine's referenced\n    feeds that have NOT yet been added to the Magazine. Excludes Posts whose\n    refs already appear in magazine.posts.\n  input:\n    magazineId: DXN\n  output:\n    Array<{\n      postId: DXN,\n      feedName?: string,\n      title?: string,\n      description?: string,\n      author?: string,\n      published?: string\n    }>\n  effects: [echo:read]\n  note: >\n    Deliberately excludes the full article body and image — the agent\n    decides from summaries whether to call FetchArticleContent.\n```\n\n```mdl\nop FetchArticleContent\n  desc: >\n    Fetches post.link over HTTP and returns extracted plain text plus any\n    image URLs found (og:image and <img> tags). Pure read — does not mutate\n    the Post. Reusable by the future tagging feature.\n  input:\n    postId: DXN\n  output:\n    {\n      text: string,\n      imageUrls: string[]\n    }\n  errors:\n    FetchFailed: HTTP error or network failure\n    NoLink: the Post has no `link` field\n  effects: [http, echo:read]\n```\n\n```mdl\nop AddPostToMagazine\n  desc: >\n    Writes snippet and imageUrl onto the Post and appends the Post's ref to\n    magazine.posts. Idempotent — no-op if the Post ref is already present.\n  input:\n    magazineId: DXN\n    postId: DXN\n    snippet: string\n    imageUrl?: string\n  output: Post\n  effects: [echo:write]\n```\n\n```mdl\nop CurateMagazine\n  desc: >\n    Deterministic one-shot curation invoked by the Curate button. For each\n    uncurated candidate Post, derives a snippet and hero image from the Post's\n    existing `description` (no HTTP) and appends the enriched Post ref to\n    `magazine.posts`. Skips Posts with empty descriptions.\n  input:\n    magazineId: DXN\n  output:\n    added: number\n  effects: [echo:write]\n  note: >\n    Exists alongside the skill. The deterministic path gives the button\n    an immediate, reliable result without needing an LLM. The agent path\n    (via the skill's fine-grained tools) delivers instruction-driven,\n    higher-quality curation through chat.\n```\n\n## Features\n\n```mdl\nfeat F-1: Magazine Type\n  desc: Introduce the Magazine ECHO type with feeds, instructions, and curated posts.\n\n  req F-1.1: User can create a Magazine object via the plugin's create menu.\n  req F-1.2: Magazine.name is optional; magazine is labeled by name when set.\n  req F-1.3: Magazine.feeds is an array of Ref<Feed>; empty by default.\n  req F-1.4: Magazine.routine is an optional Ref<Routine>, created lazily on first curate; hidden from the standard form input. Magazine.topic holds the create-dialog editorial seed until the Routine exists.\n  req F-1.5: Magazine.posts is an array of Ref<Post>; empty by default; insertion order preserved.\n```\n\n```mdl\nfeat F-2: Post Extensions\n  desc: Add optional snippet, imageUrl, readAt, and tags to existing Post type.\n\n  req F-2.1: All new fields are optional; existing Post objects load unchanged.\n  req F-2.2: snippet is a plain string; no max length enforced at schema level.\n  req F-2.3: imageUrl is a plain string URL.\n  req F-2.4: readAt is an ISO 8601 timestamp; presence = read, absence = unread.\n  req F-2.5: tags is a string array; defaults to empty; not populated in this revision.\n```\n\n```mdl\nfeat F-3: Magazine Curate Flow\n  desc: Sync referenced feeds then invoke the agent to curate articles.\n\n  req F-3.1: MagazineArticle toolbar includes a Curate button.\n  req F-3.2:\n    when: user clicks Curate\n    then: button shows spinner, is disabled, tooltip shows phase ('Syncing feeds...' / 'Curating articles...')\n  req F-3.3:\n    when: Curate runs\n    then: SyncFeed invoked in parallel for each Ref in magazine.feeds; per-feed failures are collected but do not abort the flow\n  req F-3.4:\n    when: all feed syncs resolve (success or failure)\n    then: CurateMagazine operation is invoked with the Magazine ref\n  req F-3.5:\n    when: CurateMagazine completes\n    then: button returns to idle; reactive UI renders the new tiles\n  req F-3.6:\n    when: magazine.feeds is empty\n    then: Curate button is disabled with tooltip 'Add at least one feed first'\n  req F-3.7: Re-clicking Curate while running is a no-op (button disabled; in-memory running flag).\n```\n\n```mdl\nfeat F-4: Agent Curation Behavior\n  desc: Agent uses tools to select, fetch, and add Posts.\n\n  req F-4.1: Agent reads magazine.instructions Text and magazine.feeds refs from context.\n  req F-4.2: Agent calls ListCandidatePosts(magazineId) to receive unenriched candidates.\n  req F-4.3: Agent filters candidates against the instructions and skips low-relevance posts.\n  req F-4.4: For each selected Post, agent calls FetchArticleContent(postId) to obtain text and images.\n  req F-4.5: Agent produces a concise snippet (target ~200 chars) and selects the best image URL.\n  req F-4.6: Agent calls AddPostToMagazine(magazineId, postId, snippet, imageUrl).\n  req F-4.7: AddPostToMagazine is idempotent; re-invocation with the same postId is a no-op append.\n```\n\n```mdl\nfeat F-5: Masonry Display\n  desc: Render curated Posts in a Masonry grid with rich tiles.\n\n  req F-5.1: MagazineArticle renders magazine.posts in reverse insertion order (newest first) in a Masonry grid.\n  req F-5.2: Each tile shows imageUrl (if present), title, snippet, feed name, author, published date.\n  req F-5.3: Tile tags row renders only when post.tags.length > 0.\n  req F-5.4: Tiles where post.readAt is set are visually dimmed.\n  req F-5.5: Clicking a tile opens the ArticleReader for that Post.\n  req F-5.6: Opening the reader sets post.readAt to the current ISO timestamp if not already set.\n  req F-5.7: Empty state — when magazine.posts is empty — shows: 'No articles yet. Add feeds and press Curate.'\n  req F-5.8: Grid uses the @dxos/react-ui-masonry Masonry component.\n```\n\n```mdl\nfeat F-6: Post Article Detail (master-detail via layout dispatch)\n  desc: Post detail is rendered by a standalone PostArticle surface. The\n        master (MagazineArticle) does not compose the detail inline;\n        instead it asks the deck's `useShowItem` to select the post and\n        route the detail to the appropriate place for the current\n        layout mode (complementary drawer / sibling plank / companion).\n\n  req F-6.1: PostArticle is registered as a React surface matching\n             `object(Article, Subscription.Post)` — usable anywhere an\n             article for a Post is requested.\n  req F-6.2: PostArticle is a Panel with a Toolbar. The 'Open original'\n             link lives in the toolbar. Body shows metadata, hero image,\n             and snippet.\n  req F-6.3:\n    when: user clicks a tile in MagazineArticle\n    then:\n      - post.readAt is set to the current ISO timestamp if unset\n      - useShowItem is invoked with:\n          contextId = magazine attendableId\n          selectionId = post.id\n          companion = linkedSegment('post')\n          path = getObjectPathFromObject(post)\n  req F-6.4:\n    when: useShowItem is invoked in 'simple' layout mode\n    then: the complementary sidebar opens on linkedSegment('post')\n  req F-6.5:\n    when: useShowItem is invoked in 'multi' layout mode\n    then: a sibling plank opens for the post's path, pivoted on the magazine\n  req F-6.6:\n    when: useShowItem is invoked in the default ('deck') layout mode\n    then: the current plank's companion changes to linkedSegment('post')\n  req F-6.7: An app-graph extension under each Magazine node exposes a\n             companion node for linkedSegment('post') whose data resolves\n             to the currently-selected Post from magazine.posts.\n```\n\n```mdl\nfeat F-7: Future Tagging (schema scaffolding only)\n  desc: Schema fields in place so the tagging feature composes without migration.\n\n  req F-7.1: Post.tags exists as Schema.Array(Schema.String).pipe(Schema.optional).\n  req F-7.2: MagazineTile renders a tags row conditionally on tags.length > 0.\n  req F-7.3: FetchArticleContent is reusable as the input stage for a future TagPosts operation.\n  note: >\n    Later features (out of scope): TagPosts operation, a MagazineTagger skill\n    (or extension of MagazineSkill), tag-filter chips in the toolbar,\n    'Find more like this' action, and 'Suggest feeds' action proposing new Feed\n    URLs based on accumulated tag distribution.\n```\n\n## Acceptance\n\n```mdl\ntest T-1: Create Magazine\n  given: user is in a space in Composer\n  when: user creates a Magazine via the plugin's create menu\n  then:\n    - Magazine object created in space\n    - Magazine.feeds is an empty array\n    - Magazine.posts is an empty array\n    - Magazine.instructions is a Ref to an empty Text object\n```\n\n```mdl\ntest T-2: Post schema backward compatibility\n  given: a Post created before this revision exists in the space\n  when: the new plugin version loads\n  then:\n    - Post loads without schema error\n    - Post.snippet, Post.imageUrl, Post.readAt, Post.tags are all undefined / empty\n```\n\n```mdl\ntest T-3: Curate button disabled without feeds\n  given: a Magazine with magazine.feeds.length === 0\n  when: MagazineArticle renders\n  then:\n    - Curate button is disabled\n    - tooltip text === 'Add at least one feed first'\n```\n\n```mdl\ntest T-4: Curate flow runs sync then deterministic curation\n  given: a Magazine with two referenced feeds, each with unsynced remote posts\n  when: user clicks Curate\n  then:\n    - SyncFeed invoked once per referenced feed\n    - After all SyncFeed calls resolve, CurateMagazine operation is invoked\n    - Magazine.posts grows by the count returned from CurateMagazine\n    - Button returns to idle\n```\n\n```mdl\ntest T-4a: Agent curation via skill\n  given: a chat referencing a Magazine whose MagazineSkill is active\n  when: the agent is prompted to curate the magazine\n  then:\n    - Agent calls ListCandidatePosts, FetchArticleContent, AddPostToMagazine\n    - Magazine.posts grows by the agent-selected count\n  note: >\n    The skill path is distinct from the Curate button (T-4). The button\n    runs the deterministic CurateMagazine op; agents invoke the fine-grained\n    tools through chat.\n```\n\n```mdl\ntest T-5: Partial feed sync failure is non-fatal\n  given: a Magazine with two feeds; one feed's URL returns 500\n  when: user clicks Curate\n  then:\n    - CurateMagazine still runs against posts from the successful feed\n    - Error surfaced via a localized message in the status bar\n```\n\n```mdl\ntest T-6: ListCandidatePosts excludes curated\n  given: a Magazine whose posts array already contains refs to two Posts from feed A\n  when: ListCandidatePosts(magazineId) is called\n  then: returned list contains no entries whose postId matches an existing magazine.posts ref\n```\n\n```mdl\ntest T-7: AddPostToMagazine is idempotent\n  given: a Magazine already containing a Post ref\n  when: AddPostToMagazine invoked with the same postId\n  then:\n    - magazine.posts length unchanged\n    - Post.snippet and Post.imageUrl left unchanged (no overwrite on duplicate)\n```\n\n```mdl\ntest T-8: FetchArticleContent surfaces images\n  given: a Post whose link resolves to an HTML page with og:image and two <img> tags\n  when: FetchArticleContent(postId) is called\n  then:\n    - output.text contains the page's main text\n    - output.imageUrls includes the og:image URL\n    - output.imageUrls includes URLs from <img> tags\n```\n\n```mdl\ntest T-9: Tile dimming on read\n  given: a Magazine with one Post where readAt is unset\n  when: user clicks the tile\n  then:\n    - ArticleReader opens for that Post\n    - Post.readAt is set to an ISO timestamp\n    - On reader close, the tile renders dimmed\n```\n\n```mdl\ntest T-10: Tile metadata\n  given: a curated Post with title, snippet, imageUrl, author, published, and a feed with name\n  when: MagazineTile renders\n  then:\n    - hero image rendered from imageUrl\n    - title rendered with 2-line clamp\n    - snippet rendered with 3-line clamp\n    - metadata row shows feed name, author, and a formatted date\n    - tags row is NOT rendered (tags is empty)\n```\n\n---\n\n## Design Notes\n\n### Curation via Routine (this revision)\n\nCuration runs a persisted **Routine** rather than an ephemeral one. The Magazine\nno longer carries an `instructions` Template; it carries an optional\n`routine: Ref<Routine>` plus a `topic` seed string.\n\n- **Eager creation.** `Magazine.make()` creates the `Routine` at magazine\n  instantiation time. The Routine's `instructions` Text is seeded with the\n  default editorial methodology and an optional topic woven into a `## Topic`\n  section; it references the MagazineSkill and is parented to the magazine\n  (cascade-delete). The magazine is added to the Routine's `objects` (context).\n- **Run.** The curate op invokes `AgentPrompt` (Run Routine) with\n  `prompt: magazine.routine` and the candidate JSON `input`; it decodes the\n  `completeJob` structured output and applies selections mechanically (keep-bound,\n  per-post snippet/imageUrl). No ephemeral routine is constructed.\n- **Instruction split.** Skill = HOW (FetchArticleContent + completeJob\n  contract). Routine = editorial (selection criteria, dedup, snippet style,\n  hero-image choice) + topic. This removes the prior overlap where the skill\n  held both.\n- **Properties editing.** The `routine` field carries `FormInlineAnnotation`,\n  so the Routine's own fields (name, description, instructions) render inline in\n  the generic `DefaultProperties` companion — no custom surface needed.\n- **Template.** `Template` is retained (it is the type of `Skill.instructions`\n  and is used across the codebase). The Magazine simply stops using it; the\n  Routine's `instructions` is a plain `Ref<Text>`.\n\n### Content Flow\n\nTwo curation paths exist side-by-side:\n\n- **Button path (deterministic).** The Curate toolbar button runs `SyncFeed`\n  per referenced feed, then invokes `CurateMagazine`. Snippets and images are\n  derived from each Post's existing `description` field (no HTTP, no LLM).\n  Chosen for the user-initiated button because it is fast, reliable, and does\n  not depend on an LLM runtime being present.\n- **Agent path (skill).** The `MagazineSkill` exposes three fine-grained\n  tools (`ListCandidatePosts`, `FetchArticleContent`, `AddPostToMagazine`) and\n  an instruction template that tells an agent to consult `Magazine.instructions`\n  when selecting Posts. Triggered when an agent chat references the Magazine —\n  not when the button is clicked. Delivers higher-quality curation (full-article\n  fetch + LLM-driven selection) at the cost of latency and LLM availability.\n\n`SyncFeed` is always run deterministically (either by the button or outside\nthe scope of this feature). Neither curation path fetches feed indices on its\nown — that is `SyncFeed`'s job.\n\n### Tool Granularity\n\nThree tools rather than one combined `curateMagazine` tool:\n\n- `ListCandidatePosts` returns lightweight summaries so the agent can triage\n  cheaply without loading article bodies.\n- `FetchArticleContent` is a read-only HTTP fetch + extract; it is reusable by\n  the future `TagPosts` operation which will need the same inputs.\n- `AddPostToMagazine` is the sole mutation. Idempotence lives in this tool\n  (by ref-set membership check) rather than in the prompt.\n\nQuality of selection is the agent's job; the tools deliberately don't try to\nrank or filter on the agent's behalf.\n\n### Snippet Storage\n\n`Post.snippet` is a plain inline string, not a `Ref<Text>`. Snippets are\nshort (~200 chars target) and read-only to the user; the `Ref<Text>` indirection\nused for `Agent.instructions` and `Magazine.instructions` is appropriate for\nlong-form, user-editable content and is not needed here.\n\n### Read State\n\nRepresented as an optional ISO timestamp `readAt`, not a boolean or enum.\nAbsence = unread; presence = read (at that time). This leaves room to show\n\"read 2 days ago\" or to expire reads without a schema change.\n\n### Image Extraction\n\n`FetchArticleContent` returns a list of candidate image URLs; the agent picks\nthe \"best\" one for the Post's `imageUrl`. The prompt should prefer `og:image`\nwhen present. If no suitable image exists the Post is still added with\n`imageUrl` undefined — `MagazineTile` renders without the image region.\n\nHTML parsing uses whatever parser the existing codebase already uses for\nsimilar tasks. If no parser is in use, `linkedom` is the proposed addition —\nsmall, no-DOM-globals footprint, works in Node and browser. Addition of a\nparser dependency is a decision point flagged during implementation planning.\n\n### Deduplication Policy\n\nDeduplication is keyed on Post ref identity, not on URL or guid. If a Post is\nremoved from the Magazine and later re-curated, the agent will re-add it.\nDedup across a Feed's historical sync is out of scope — `Feed` already\ndeduplicates on `guid` when syncing.\n\n### Relationship to Future Tagging\n\nThe tagging feature is strictly additive to this design:\n\n- `Post.tags` already exists as an optional string array.\n- `FetchArticleContent` is the reusable read-stage for tagging.\n- `MagazineTile` renders a tags row when non-empty — no UI change needed.\n- A `TagPosts` operation and either an extended prompt in `MagazineSkill`\n  or a second `MagazineTagger` skill will complete the feature in a later\n  revision.\n\nFurther future work enabled by tags (all out of scope here): tag-filter chips\nin the Magazine toolbar; a \"Find more like this\" action prompting the agent\nto curate Posts with overlapping tags; a \"Suggest feeds\" action proposing new\nFeed URLs based on accumulated tag distribution.\n\n### Out of Scope\n\n- Rendering the full original article body inside the reader (would require\n  storing full extracted text; current design stores only the snippet).\n- Scheduled / background Curate runs — this revision only supports the\n  explicit toolbar-triggered flow.\n- Cross-Magazine deduplication — two Magazines may both curate the same Post.\n- Editing or regenerating a snippet after curation — re-curation is the path\n  to different content.\n",
+	mimeType: "application/x-mdl"
+} }), AppPlugin.addSchemaModule({ schema: [
+	Subscription.Subscription,
+	Subscription.Post,
+	Subscription.PostContent,
+	Magazine.Magazine,
+	Instructions.Instructions,
+	StateMap.StateMap,
+	TagIndex.TagIndex
+] }), AppPlugin.addSkillDefinitionModule({ activate: SkillDefinition }), AppPlugin.addSurfaceModule({ activate: ReactSurface }), AppPlugin.addTranslationsModule({ translations }), Plugin.addModule({
+	id: "magazine-automation-templates",
+	activatesOn: AppActivationEvents.SetupSchema,
+	activate: RoutineTemplates
+}), Plugin.make);
+//#endregion
+export { MagazinePlugin, MagazinePlugin as default };
+
+//# sourceMappingURL=MagazinePlugin.mjs.map

package/dist/lib/MagazinePlugin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"MagazinePlugin.mjs","names":[],"sources":["../../src/MagazinePlugin.tsx"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport { ActivationEvent, Plugin } from '@dxos/app-framework';\nimport { AppActivationEvents, AppPlugin } from '@dxos/app-toolkit';\nimport { Instructions } from '@dxos/compute';\nimport { AttentionEvents } from '@dxos/plugin-attention';\nimport { StateMap, TagIndex } from '@dxos/schema';\n\nimport {\n  AppGraphBuilder,\n  CreateObject,\n  OperationHandler,\n  ReactSurface,\n  RoutineTemplates,\n  SkillDefinition,\n} from '#capabilities';\nimport { meta } from '#meta';\nimport { translations } from '#translations';\nimport { Magazine, Subscription } from '#types';\n\n// eslint-disable-next-line import/no-relative-packages\nimport pluginSpec from '../PLUGIN.mdl?raw';\n\nexport const MagazinePlugin = Plugin.define(meta).pipe(\n  AppPlugin.addAppGraphModule({\n    activatesOn: ActivationEvent.allOf(AppActivationEvents.SetupAppGraph, AttentionEvents.AttentionReady),\n    activate: AppGraphBuilder,\n  }),\n  AppPlugin.addCreateObjectModule({ activate: CreateObject }),\n  AppPlugin.addOperationHandlerModule({ activate: OperationHandler }),\n  AppPlugin.addPluginAssetModule({\n    asset: { pluginId: meta.profile.key, path: 'PLUGIN.mdl', content: pluginSpec, mimeType: 'application/x-mdl' },\n  }),\n  AppPlugin.addSchemaModule({\n    schema: [\n      Subscription.Subscription,\n      Subscription.Post,\n      Subscription.PostContent,\n      Magazine.Magazine,\n      Instructions.Instructions,\n      StateMap.StateMap,\n      TagIndex.TagIndex,\n    ],\n  }),\n  AppPlugin.addSkillDefinitionModule({ activate: SkillDefinition }),\n  AppPlugin.addSurfaceModule({ activate: ReactSurface }),\n  AppPlugin.addTranslationsModule({ translations }),\n  Plugin.addModule({\n    id: 'magazine-automation-templates',\n    activatesOn: AppActivationEvents.SetupSchema,\n    activate: RoutineTemplates,\n  }),\n  Plugin.make,\n);\n\nexport default MagazinePlugin;\n"],"mappings":";;;;;;;;;;;AAyBA,IAAa,iBAAiB,OAAO,OAAO,IAAI,CAAC,CAAC,KAChD,UAAU,kBAAkB;CAC1B,aAAa,gBAAgB,MAAM,oBAAoB,eAAe,gBAAgB,cAAc;CACpG,UAAU;AACZ,CAAC,GACD,UAAU,sBAAsB,EAAE,UAAU,aAAa,CAAC,GAC1D,UAAU,0BAA0B,EAAE,UAAU,iBAAiB,CAAC,GAClE,UAAU,qBAAqB,EAC7B,OAAO;CAAE,UAAU,KAAK,QAAQ;CAAK,MAAM;CAAc,SAAS;CAAY,UAAU;AAAoB,EAC9G,CAAC,GACD,UAAU,gBAAgB,EACxB,QAAQ;CACN,aAAa;CACb,aAAa;CACb,aAAa;CACb,SAAS;CACT,aAAa;CACb,SAAS;CACT,SAAS;AACX,EACF,CAAC,GACD,UAAU,yBAAyB,EAAE,UAAU,gBAAgB,CAAC,GAChE,UAAU,iBAAiB,EAAE,UAAU,aAAa,CAAC,GACrD,UAAU,sBAAsB,EAAE,aAAa,CAAC,GAChD,OAAO,UAAU;CACf,IAAI;CACJ,aAAa,oBAAoB;CACjC,UAAU;AACZ,CAAC,GACD,OAAO,IACT"}

package/dist/lib/MagazinePlugin.workerd.mjs

@@ -0,0 +1,26 @@
+import { t as operation_handler_default } from "./chunk-operation-handler.mjs";
+import { t as skillDefinition } from "./chunk-skill-definition.mjs";
+import { Plugin } from "@dxos/app-framework";
+import { StateMap, TagIndex } from "@dxos/schema";
+import { meta } from "#meta";
+import { AppPlugin } from "@dxos/app-toolkit";
+import { Magazine, Subscription } from "#types";
+//#region src/MagazinePlugin.workerd.ts
+var MagazinePlugin = Plugin.define(meta).pipe(AppPlugin.addSkillDefinitionModule({
+	id: "skill-definition",
+	activate: skillDefinition
+}), AppPlugin.addOperationHandlerModule({
+	id: "operation-handler",
+	activate: operation_handler_default
+}), AppPlugin.addSchemaModule({ schema: [
+	Subscription.Subscription,
+	Subscription.Post,
+	Subscription.PostContent,
+	Magazine.Magazine,
+	StateMap.StateMap,
+	TagIndex.TagIndex
+] }), Plugin.make);
+//#endregion
+export { MagazinePlugin, MagazinePlugin as default };
+
+//# sourceMappingURL=MagazinePlugin.workerd.mjs.map

package/dist/lib/MagazinePlugin.workerd.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"MagazinePlugin.workerd.mjs","names":[],"sources":["../../src/MagazinePlugin.workerd.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport { Plugin } from '@dxos/app-framework';\nimport { AppPlugin } from '@dxos/app-toolkit';\nimport { StateMap, TagIndex } from '@dxos/schema';\n\nimport { meta } from '#meta';\nimport { Magazine, Subscription } from '#types';\n\nimport OperationHandler from './capabilities/operation-handler';\nimport SkillDefinition from './capabilities/skill-definition';\n\nexport const MagazinePlugin = Plugin.define(meta).pipe(\n  AppPlugin.addSkillDefinitionModule({ id: 'skill-definition', activate: SkillDefinition }),\n  AppPlugin.addOperationHandlerModule({ id: 'operation-handler', activate: OperationHandler }),\n  AppPlugin.addSchemaModule({\n    schema: [\n      Subscription.Subscription,\n      Subscription.Post,\n      Subscription.PostContent,\n      Magazine.Magazine,\n      StateMap.StateMap,\n      TagIndex.TagIndex,\n    ],\n  }),\n  Plugin.make,\n);\n\nexport default MagazinePlugin;\n"],"mappings":";;;;;;;;AAcA,IAAa,iBAAiB,OAAO,OAAO,IAAI,CAAC,CAAC,KAChD,UAAU,yBAAyB;CAAE,IAAI;CAAoB,UAAU;AAAgB,CAAC,GACxF,UAAU,0BAA0B;CAAE,IAAI;CAAqB,UAAU;AAAiB,CAAC,GAC3F,UAAU,gBAAgB,EACxB,QAAQ;CACN,aAAa;CACb,aAAa;CACb,aAAa;CACb,SAAS;CACT,SAAS;CACT,SAAS;AACX,EACF,CAAC,GACD,OAAO,IACT"}

package/dist/lib/atoms.mjs

@@ -0,0 +1,175 @@
+import { f as SYSTEM_TAGS, v as pickLatestPostContent, y as queryPostContentForPost } from "./chunk-types.mjs";
+import { n as publishedTimestamp } from "./chunk-date.mjs";
+import { n as getSnippet, t as getImageUrl } from "./chunk-post-content.mjs";
+import { Filter, Obj, Tag } from "@dxos/echo";
+import { StateMap, TagIndex } from "@dxos/schema";
+import { Atom, useAtomValue } from "@effect-atom/atom-react";
+import * as Data from "effect/Data";
+//#region src/atoms/post-tags.ts
+var EMPTY_TAG_SLICE = {
+	starred: false,
+	archived: false
+};
+var EMPTY_TAG_URIS = {
+	starredUri: void 0,
+	archivedUri: void 0
+};
+/** Resolve the uri of a system Tag by foreign key (mirrors `useSystemTags`). */
+var uriForTag = (tags, key) => {
+	const match = tags.find((tag) => Obj.getKeys(tag, key.source).some((foreignKey) => foreignKey.id === key.id));
+	return match ? Obj.getURI(match).toString() : void 0;
+};
+/**
+* Resolved uris of the `starred` / `archived` system Tags, keyed by database. Fires only when the
+* Tag set changes (rare — on first star/archive). Shared by every per-Post tag slice.
+*/
+var tagUrisAtom = Atom.family((db) => db.query(Filter.type(Tag.Tag)).atom.pipe(Atom.map((tags) => ({
+	starredUri: uriForTag(tags, SYSTEM_TAGS.starred.key),
+	archivedUri: uriForTag(tags, SYSTEM_TAGS.archived.key)
+}))));
+/**
+* This Post's `{ starred, archived }`, sliced off its source Subscription's `tags`. Fires only
+* when this Post's tag membership flips — sibling Posts' tag mutations are discarded without
+* propagating. Re-initialises its tag subscription when tag uris change (first star ever in the space).
+*/
+var postTagsAtom = Atom.family((post) => Atom.make((get) => {
+	const ref = post.source;
+	if (!ref) return EMPTY_TAG_SLICE;
+	const subscription = get(ref.atom);
+	if (!subscription) return EMPTY_TAG_SLICE;
+	const tagIndex = get(subscription.tags.atom);
+	if (!tagIndex) return EMPTY_TAG_SLICE;
+	const db = Obj.getDatabase(subscription);
+	const { starredUri, archivedUri } = db ? get(tagUrisAtom(db)) : EMPTY_TAG_URIS;
+	return {
+		starred: get(TagIndex.atom(tagIndex, post.id, starredUri)),
+		archived: get(TagIndex.atom(tagIndex, post.id, archivedUri))
+	};
+}).pipe(Atom.keepAlive));
+/** This Post's tag slice (star/archive). */
+var useTagState = (post) => useAtomValue(postTagsAtom(post));
+//#endregion
+//#region src/atoms/magazine-posts.ts
+/**
+* Ordered Posts referenced by the Magazine, derived directly from the `magazine.posts` refs — no
+* query. Fires when the refs array changes (membership/order) or when a ref resolves. Resolving each
+* ref here, rather than a `reference('posts').from(Scope.space(...))` query, avoids the cross-feed
+* fan-out that returned each curated Post once per feed scope.
+*/
+var magazinePostsAtom = Atom.family((magazine) => Atom.make((get) => {
+	return [...(get(Obj.atomProperty(magazine, "posts")) ?? []).map((ref) => get(ref.atom)).filter((post) => Boolean(post))].sort((postA, postB) => publishedTimestamp(postB.published) - publishedTimestamp(postA.published));
+}));
+/**
+* Whether a Post is visible under a given view. Depends ONLY on the Post's tag slice + view, so
+* read-state changes never wake it (and effect-atom dedupes the boolean). Keyed by a value-equal
+* `Data.tuple([post, view])` rather than a nested family — the intermediate of a nested family is
+* only weakly held and could be GC'd out from under its mounted leaf atoms.
+*/
+var postVisibilityAtom = Atom.family((key) => Atom.make((get) => {
+	const [post, view] = key;
+	const { starred, archived } = get(postTagsAtom(post));
+	switch (view) {
+		case "archived": return archived;
+		case "starred": return !archived && starred;
+		default: return !archived;
+	}
+}));
+/**
+* Ordered, view-filtered Posts for a Magazine. Re-runs on membership change OR a Post crossing the
+* view's filter boundary (star/archive); never on read-state changes. Keyed by a value-equal
+* `Data.tuple([magazine, view])`.
+*/
+var visibleMagazinePostsAtom = Atom.family((key) => Atom.make((get) => {
+	const [magazine, view] = key;
+	return get(magazinePostsAtom(magazine)).filter((post) => get(postVisibilityAtom(Data.tuple(post, view))));
+}));
+/** Ordered, view-filtered Posts for a Magazine. */
+var useVisibleMagazinePosts = (magazine, view) => useAtomValue(visibleMagazinePostsAtom(Data.tuple(magazine, view)));
+//#endregion
+//#region src/atoms/post-content.ts
+/** This Post's fetched body (newest {@link Subscription.PostContent} entry), or undefined. */
+var postContentAtom = Atom.family((post) => Atom.make((get) => {
+	const ref = post.source;
+	if (!ref) return;
+	const subscription = get(ref.atom);
+	if (!subscription) return;
+	const db = Obj.getDatabase(subscription);
+	const query = queryPostContentForPost(subscription, post);
+	if (!db || !query) return;
+	return pickLatestPostContent(get(db.query(query).atom));
+}).pipe(Atom.keepAlive));
+/** This Post's fetched body, reactively. */
+var usePostContentAtom = (post) => useAtomValue(postContentAtom(post));
+//#endregion
+//#region src/atoms/post-curation.ts
+var EMPTY_CURATION_SLICE = {
+	snippet: void 0,
+	imageUrl: void 0
+};
+/**
+* This Post's magazine-scoped curation slice (snippet/imageUrl), sliced off the Magazine's
+* `postState`. Fires only when this Post's slice changes — sibling Posts' curation mutations are
+* discarded without propagating. Keyed by a value-equal `Data.tuple([post, magazine])`.
+*/
+var postCurationAtom = Atom.family((key) => Atom.make((get) => {
+	const [post, magazine] = key;
+	const stateMap = get(magazine.postState.atom);
+	if (!stateMap) return EMPTY_CURATION_SLICE;
+	const state = get(StateMap.atom(stateMap, post.id));
+	return {
+		snippet: state.snippet,
+		imageUrl: state.imageUrl
+	};
+}).pipe(Atom.keepAlive));
+/** This Post's magazine-scoped curation slice. */
+var usePostCuration = (post, magazine) => useAtomValue(postCurationAtom(Data.tuple(post, magazine)));
+//#endregion
+//#region src/atoms/post-read.ts
+var EMPTY_READ_SLICE = { readAt: void 0 };
+/**
+* This Post's `readAt`, sliced off its source Subscription's `postState`. Fires only when this
+* Post's `readAt` changes — sibling Posts' mutations are discarded without propagating.
+*/
+var postReadAtom = Atom.family((post) => Atom.make((get) => {
+	const ref = post.source;
+	if (!ref) return EMPTY_READ_SLICE;
+	const subscription = get(ref.atom);
+	if (!subscription) return EMPTY_READ_SLICE;
+	const stateMap = get(subscription.postState.atom);
+	if (!stateMap) return EMPTY_READ_SLICE;
+	return { readAt: get(StateMap.atom(stateMap, post.id)).readAt };
+}).pipe(Atom.keepAlive));
+/** This Post's read slice. */
+var useReadState = (post) => useAtomValue(postReadAtom(post));
+//#endregion
+//#region src/atoms/post-display.ts
+/**
+* Aggregate display data for one tile within a magazine. Fires only on this Post's
+* read/star/feed-name/curation changes. Keyed by a value-equal `Data.tuple([post, magazine])`.
+*
+* Snippet and imageUrl precedence: agent-written postState > RSS-derived description fallback.
+*/
+var postDisplayAtom = Atom.family((key) => Atom.make((get) => {
+	const [post, magazine] = key;
+	const snapshot = get(Obj.atom(post));
+	const ref = post.source;
+	const subscription = ref ? get(ref.atom) : void 0;
+	const feedName = subscription ? get(Obj.atomProperty(subscription, "name")) || get(Obj.atomProperty(subscription, "url")) : void 0;
+	const { readAt } = get(postReadAtom(post));
+	const { starred } = get(postTagsAtom(post));
+	const curation = get(postCurationAtom(Data.tuple(post, magazine)));
+	return {
+		post: snapshot,
+		feedName,
+		read: readAt !== void 0,
+		starred,
+		snippet: curation.snippet ?? getSnippet(snapshot),
+		imageUrl: curation.imageUrl ?? getImageUrl(snapshot)
+	};
+}).pipe(Atom.keepAlive));
+/** Aggregate per-Post display data for a magazine tile. */
+var useMagazinePostData = (post, magazine) => useAtomValue(postDisplayAtom(Data.tuple(post, magazine)));
+//#endregion
+export { postContentAtom, postCurationAtom, postDisplayAtom, postReadAtom, postTagsAtom, useMagazinePostData, usePostContentAtom, usePostCuration, useReadState, useTagState, useVisibleMagazinePosts, visibleMagazinePostsAtom };
+
+//# sourceMappingURL=atoms.mjs.map

package/dist/lib/atoms.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"atoms.mjs","names":[],"sources":["../../src/atoms/post-tags.ts","../../src/atoms/magazine-posts.ts","../../src/atoms/post-content.ts","../../src/atoms/post-curation.ts","../../src/atoms/post-read.ts","../../src/atoms/post-display.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport { Atom, useAtomValue } from '@effect-atom/atom-react';\n\nimport { type Database, Filter, Obj, Tag } from '@dxos/echo';\nimport { TagIndex } from '@dxos/schema';\n\nimport { Subscription } from '../types';\n\n/** Per-Post tag slice (star/archive membership). */\nexport type TagSlice = { starred: boolean; archived: boolean };\n\nconst EMPTY_TAG_SLICE: TagSlice = { starred: false, archived: false };\nconst EMPTY_TAG_URIS = { starredUri: undefined, archivedUri: undefined } as const;\n\n/** Resolve the uri of a system Tag by foreign key (mirrors `useSystemTags`). */\nconst uriForTag = (tags: readonly Tag.Tag[], key: { source: string; id: string }): string | undefined => {\n  const match = tags.find((tag) => Obj.getKeys(tag, key.source).some((foreignKey) => foreignKey.id === key.id));\n  return match ? Obj.getURI(match).toString() : undefined;\n};\n\n/**\n * Resolved uris of the `starred` / `archived` system Tags, keyed by database. Fires only when the\n * Tag set changes (rare — on first star/archive). Shared by every per-Post tag slice.\n */\nconst tagUrisAtom = Atom.family((db: Database.Database) =>\n  db.query(Filter.type(Tag.Tag)).atom.pipe(\n    Atom.map((tags) => ({\n      starredUri: uriForTag(tags, Subscription.SYSTEM_TAGS.starred.key),\n      archivedUri: uriForTag(tags, Subscription.SYSTEM_TAGS.archived.key),\n    })),\n  ),\n);\n\n/**\n * This Post's `{ starred, archived }`, sliced off its source Subscription's `tags`. Fires only\n * when this Post's tag membership flips — sibling Posts' tag mutations are discarded without\n * propagating. Re-initialises its tag subscription when tag uris change (first star ever in the space).\n */\nexport const postTagsAtom = Atom.family((post: Subscription.Post) =>\n  Atom.make<TagSlice>((get) => {\n    const ref = post.source;\n    if (!ref) {\n      return EMPTY_TAG_SLICE;\n    }\n    const subscription = get(ref.atom);\n    if (!subscription) {\n      return EMPTY_TAG_SLICE;\n    }\n    const tagIndex = get(subscription.tags.atom);\n    if (!tagIndex) {\n      return EMPTY_TAG_SLICE;\n    }\n    const db = Obj.getDatabase(subscription);\n    const { starredUri, archivedUri } = db ? get(tagUrisAtom(db)) : EMPTY_TAG_URIS;\n    return {\n      starred: get(TagIndex.atom(tagIndex, post.id, starredUri)),\n      archived: get(TagIndex.atom(tagIndex, post.id, archivedUri)),\n    };\n  }).pipe(Atom.keepAlive),\n);\n\n/** This Post's tag slice (star/archive). */\nexport const useTagState = (post: Subscription.Post): TagSlice => useAtomValue(postTagsAtom(post));\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport { Atom, useAtomValue } from '@effect-atom/atom-react';\nimport * as Data from 'effect/Data';\n\nimport { Obj } from '@dxos/echo';\n\nimport { type Magazine, type Subscription } from '../types';\nimport { publishedTimestamp } from '../util/date';\nimport { postTagsAtom } from './post-tags';\n\n/**\n * Tile filter mode. Mutually exclusive — `default` shows everything except archived,\n * `starred` filters to starred posts, `archived` shows only archived posts.\n */\nexport type MagazineView = 'default' | 'starred' | 'archived';\n\n/**\n * Ordered Posts referenced by the Magazine, derived directly from the `magazine.posts` refs — no\n * query. Fires when the refs array changes (membership/order) or when a ref resolves. Resolving each\n * ref here, rather than a `reference('posts').from(Scope.space(...))` query, avoids the cross-feed\n * fan-out that returned each curated Post once per feed scope.\n */\nconst magazinePostsAtom = Atom.family((magazine: Magazine.Magazine) =>\n  Atom.make<Subscription.Post[]>((get) => {\n    const refs = get(Obj.atomProperty(magazine, 'posts')) ?? [];\n    const posts = refs.map((ref) => get(ref.atom)).filter((post): post is Subscription.Post => Boolean(post));\n    return [...posts].sort((postA, postB) => publishedTimestamp(postB.published) - publishedTimestamp(postA.published));\n  }),\n);\n\n/**\n * Whether a Post is visible under a given view. Depends ONLY on the Post's tag slice + view, so\n * read-state changes never wake it (and effect-atom dedupes the boolean). Keyed by a value-equal\n * `Data.tuple([post, view])` rather than a nested family — the intermediate of a nested family is\n * only weakly held and could be GC'd out from under its mounted leaf atoms.\n */\nconst postVisibilityAtom = Atom.family((key: readonly [Subscription.Post, MagazineView]) =>\n  Atom.make<boolean>((get) => {\n    const [post, view] = key;\n    const { starred, archived } = get(postTagsAtom(post));\n    switch (view) {\n      case 'archived':\n        return archived;\n      case 'starred':\n        return !archived && starred;\n      default:\n        return !archived;\n    }\n  }),\n);\n\n/**\n * Ordered, view-filtered Posts for a Magazine. Re-runs on membership change OR a Post crossing the\n * view's filter boundary (star/archive); never on read-state changes. Keyed by a value-equal\n * `Data.tuple([magazine, view])`.\n */\nexport const visibleMagazinePostsAtom = Atom.family((key: readonly [Magazine.Magazine, MagazineView]) =>\n  Atom.make<Subscription.Post[]>((get) => {\n    const [magazine, view] = key;\n    const posts = get(magazinePostsAtom(magazine));\n    return posts.filter((post) => get(postVisibilityAtom(Data.tuple(post, view))));\n  }),\n);\n\n/** Ordered, view-filtered Posts for a Magazine. */\nexport const useVisibleMagazinePosts = (magazine: Magazine.Magazine, view: MagazineView): Subscription.Post[] =>\n  useAtomValue(visibleMagazinePostsAtom(Data.tuple(magazine, view)));\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport { Atom, useAtomValue } from '@effect-atom/atom-react';\n\nimport { Obj } from '@dxos/echo';\n\nimport { Subscription } from '../types';\n\n/** This Post's fetched body (newest {@link Subscription.PostContent} entry), or undefined. */\nexport const postContentAtom = Atom.family((post: Subscription.Post) =>\n  Atom.make<Subscription.PostContent | undefined>((get) => {\n    const ref = post.source;\n    if (!ref) {\n      return undefined;\n    }\n    const subscription = get(ref.atom);\n    if (!subscription) {\n      return undefined;\n    }\n    const db = Obj.getDatabase(subscription);\n    const query = Subscription.queryPostContentForPost(subscription, post);\n    if (!db || !query) {\n      return undefined;\n    }\n    const entries = get(db.query(query).atom);\n    return Subscription.pickLatestPostContent(entries);\n  }).pipe(Atom.keepAlive),\n);\n\n/** This Post's fetched body, reactively. */\nexport const usePostContentAtom = (post: Subscription.Post): Subscription.PostContent | undefined =>\n  useAtomValue(postContentAtom(post));\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport { Atom, useAtomValue } from '@effect-atom/atom-react';\nimport * as Data from 'effect/Data';\n\nimport { StateMap } from '@dxos/schema';\n\nimport { Magazine, type Subscription } from '../types';\n\n/** Per-Post magazine-scoped curation slice (agent-written snippet/hero image). */\nexport type CurationSlice = { snippet: string | undefined; imageUrl: string | undefined };\n\nconst EMPTY_CURATION_SLICE: CurationSlice = { snippet: undefined, imageUrl: undefined };\n\n/**\n * This Post's magazine-scoped curation slice (snippet/imageUrl), sliced off the Magazine's\n * `postState`. Fires only when this Post's slice changes — sibling Posts' curation mutations are\n * discarded without propagating. Keyed by a value-equal `Data.tuple([post, magazine])`.\n */\nexport const postCurationAtom = Atom.family((key: readonly [Subscription.Post, Magazine.Magazine]) =>\n  Atom.make<CurationSlice>((get) => {\n    const [post, magazine] = key;\n    const stateMap = get(magazine.postState.atom);\n    if (!stateMap) {\n      return EMPTY_CURATION_SLICE;\n    }\n    const state = get(StateMap.atom<Magazine.PostState>(stateMap, post.id));\n    return { snippet: state.snippet, imageUrl: state.imageUrl };\n  }).pipe(Atom.keepAlive),\n);\n\n/** This Post's magazine-scoped curation slice. */\nexport const usePostCuration = (post: Subscription.Post, magazine: Magazine.Magazine): CurationSlice =>\n  useAtomValue(postCurationAtom(Data.tuple(post, magazine)));\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport { Atom, useAtomValue } from '@effect-atom/atom-react';\n\nimport { StateMap } from '@dxos/schema';\n\nimport { Subscription } from '../types';\n\n/** Per-Post read slice. */\nexport type ReadSlice = { readAt: string | undefined };\n\nconst EMPTY_READ_SLICE: ReadSlice = { readAt: undefined };\n\n/**\n * This Post's `readAt`, sliced off its source Subscription's `postState`. Fires only when this\n * Post's `readAt` changes — sibling Posts' mutations are discarded without propagating.\n */\nexport const postReadAtom = Atom.family((post: Subscription.Post) =>\n  Atom.make<ReadSlice>((get) => {\n    const ref = post.source;\n    if (!ref) {\n      return EMPTY_READ_SLICE;\n    }\n    const subscription = get(ref.atom);\n    if (!subscription) {\n      return EMPTY_READ_SLICE;\n    }\n    const stateMap = get(subscription.postState.atom);\n    if (!stateMap) {\n      return EMPTY_READ_SLICE;\n    }\n    const state = get(StateMap.atom<Subscription.PostState>(stateMap, post.id));\n    return { readAt: state.readAt };\n  }).pipe(Atom.keepAlive),\n);\n\n/** This Post's read slice. */\nexport const useReadState = (post: Subscription.Post): ReadSlice => useAtomValue(postReadAtom(post));\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport { Atom, useAtomValue } from '@effect-atom/atom-react';\nimport * as Data from 'effect/Data';\n\nimport { Obj } from '@dxos/echo';\n\nimport { type Magazine, type Subscription } from '../types';\nimport { getImageUrl, getSnippet } from '../util/post-content';\nimport { postCurationAtom } from './post-curation';\nimport { postReadAtom } from './post-read';\nimport { postTagsAtom } from './post-tags';\n\n/** Aggregate per-Post display data folded from the Post + its source Subscription's per-Post slice. */\nexport type MagazinePostData = {\n  post: Obj.Snapshot<Subscription.Post>;\n  feedName: string | undefined;\n  read: boolean;\n  starred: boolean;\n  snippet: string;\n  imageUrl: string | undefined;\n};\n\n/**\n * Aggregate display data for one tile within a magazine. Fires only on this Post's\n * read/star/feed-name/curation changes. Keyed by a value-equal `Data.tuple([post, magazine])`.\n *\n * Snippet and imageUrl precedence: agent-written postState > RSS-derived description fallback.\n */\nexport const postDisplayAtom = Atom.family((key: readonly [Subscription.Post, Magazine.Magazine]) =>\n  Atom.make<MagazinePostData>((get) => {\n    const [post, magazine] = key;\n    const snapshot = get(Obj.atom(post));\n    const ref = post.source;\n    const subscription = ref ? get(ref.atom) : undefined;\n    // `name`/`url` via property atoms — fire only on name/url change (e.g. after first sync).\n    const feedName = subscription\n      ? get(Obj.atomProperty(subscription, 'name')) || get(Obj.atomProperty(subscription, 'url'))\n      : undefined;\n    const { readAt } = get(postReadAtom(post));\n    const { starred } = get(postTagsAtom(post));\n    // Agent-written snippet/imageUrl (granular per-Post slice); fall back to description derivation.\n    const curation = get(postCurationAtom(Data.tuple(post, magazine)));\n    return {\n      post: snapshot,\n      feedName,\n      read: readAt !== undefined,\n      starred,\n      snippet: curation.snippet ?? getSnippet(snapshot),\n      imageUrl: curation.imageUrl ?? getImageUrl(snapshot),\n    };\n  }).pipe(Atom.keepAlive),\n);\n\n/** Aggregate per-Post display data for a magazine tile. */\nexport const useMagazinePostData = (post: Subscription.Post, magazine: Magazine.Magazine): MagazinePostData =>\n  useAtomValue(postDisplayAtom(Data.tuple(post, magazine)));\n"],"mappings":"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"}

package/dist/lib/capabilities.mjs

@@ -0,0 +1,12 @@
+import { Capability } from "@dxos/app-framework";
+//#region src/capabilities/index.ts
+var AppGraphBuilder = Capability.lazy("AppGraphBuilder", () => import("./chunk-app-graph-builder.mjs"));
+var RoutineTemplates = Capability.lazy("RoutineTemplates", () => import("./chunk-routine-templates.mjs"));
+var SkillDefinition = Capability.lazy("SkillDefinition", () => import("./chunk-skill-definition.mjs").then((n) => n.n));
+var CreateObject = Capability.lazy("CreateObject", () => import("./chunk-create-object.mjs"));
+var OperationHandler = Capability.lazy("OperationHandler", () => import("./chunk-operation-handler.mjs").then((n) => n.n));
+var ReactSurface = Capability.lazy("ReactSurface", () => import("./chunk-react-surface.mjs"));
+//#endregion
+export { AppGraphBuilder, CreateObject, OperationHandler, ReactSurface, RoutineTemplates, SkillDefinition };
+
+//# sourceMappingURL=capabilities.mjs.map

package/dist/lib/capabilities.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.mjs","names":[],"sources":["../../src/capabilities/index.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport { Capability } from '@dxos/app-framework';\nimport type { OperationHandlerSet } from '@dxos/compute';\n\nexport const AppGraphBuilder = Capability.lazy('AppGraphBuilder', () => import('./app-graph-builder'));\nexport const RoutineTemplates = Capability.lazy('RoutineTemplates', () => import('./routine-templates'));\nexport const SkillDefinition = Capability.lazy('SkillDefinition', () => import('./skill-definition'));\nexport const CreateObject = Capability.lazy('CreateObject', () => import('./create-object'));\nexport const OperationHandler = Capability.lazy<OperationHandlerSet.OperationHandlerSet>(\n  'OperationHandler',\n  () => import('./operation-handler'),\n);\nexport const ReactSurface = Capability.lazy('ReactSurface', () => import('./react-surface'));\n"],"mappings":";;AAOA,IAAa,kBAAkB,WAAW,KAAK,yBAAyB,OAAO,gCAAsB;AACrG,IAAa,mBAAmB,WAAW,KAAK,0BAA0B,OAAO,gCAAsB;AACvG,IAAa,kBAAkB,WAAW,KAAK,yBAAyB,OAAO,+BAAqB,CAAA,MAAA,MAAA,EAAA,CAAA,CAAA;AACpG,IAAa,eAAe,WAAW,KAAK,sBAAsB,OAAO,4BAAkB;AAC3F,IAAa,mBAAmB,WAAW,KACzC,0BACM,OAAO,gCACf,CAAA,MAAA,MAAA,EAAA,CAAA,CAAA;AACA,IAAa,eAAe,WAAW,KAAK,sBAAsB,OAAO,4BAAkB"}

package/dist/lib/chunk-FeedArticle.mjs

@@ -0,0 +1,70 @@
+import { Filter, Obj, Query, Ref, Scope } from "@dxos/echo";
+import { meta } from "#meta";
+import { FeedOperation, Subscription } from "#types";
+import { useCallback, useState } from "react";
+import { Panel } from "@dxos/react-ui";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useOperationInvoker } from "@dxos/app-framework/ui";
+import { useObject, useQuery } from "@dxos/echo-react";
+import { PostStack } from "#components";
+import { Menu, MenuBuilder, useMenuBuilder } from "@dxos/react-ui-menu";
+//#region src/containers/FeedArticle/FeedToolbar.tsx
+/**
+* Reactive feed toolbar built from the menu action-graph idiom: a single Sync action. Matches the
+* magazine/post toolbars; the feed's name is surfaced by the plank chrome, not duplicated here.
+*/
+var FeedToolbar = ({ attendableId, onSync }) => {
+	const menuActions = useMenuBuilder(() => MenuBuilder.make().action("sync", {
+		label: ["sync-feed.label", { ns: meta.profile.key }],
+		icon: "ph--arrows-clockwise--regular",
+		iconOnly: true
+	}, onSync).build(), [onSync]);
+	return /* @__PURE__ */ jsx(Menu.Root, {
+		...menuActions,
+		attendableId,
+		children: /* @__PURE__ */ jsx(Panel.Toolbar, {
+			asChild: true,
+			children: /* @__PURE__ */ jsx(Menu.Toolbar, {})
+		})
+	});
+};
+FeedToolbar.displayName = "FeedToolbar";
+//#endregion
+//#region src/containers/FeedArticle/FeedArticle.tsx
+var FeedArticle = ({ role, subject, attendableId }) => {
+	const { invokePromise } = useOperationInvoker();
+	const [currentPostId, setCurrentPostId] = useState();
+	const [subscription] = useObject(subject);
+	const [postFeed] = useObject(subscription?.feed);
+	const posts = useQuery(Obj.getDatabase(subscription), postFeed ? Query.select(Filter.type(Subscription.Post)).from(Scope.feed(Obj.getURI(postFeed))) : Query.select(Filter.nothing()));
+	const handleAction = useCallback((action) => {
+		if (action.type === "current") setCurrentPostId(action.postId);
+	}, []);
+	const handleSync = useCallback(() => {
+		invokePromise(FeedOperation.SyncFeed, { feed: Ref.make(subject) }, {
+			spaceId: Obj.getDatabase(subject)?.spaceId,
+			notify: { error: ["sync-feed-error.title", { ns: meta.profile.key }] }
+		});
+	}, [subject, invokePromise]);
+	return /* @__PURE__ */ jsxs(Panel.Root, {
+		role,
+		classNames: "dx-document",
+		children: [/* @__PURE__ */ jsx(FeedToolbar, {
+			attendableId,
+			onSync: handleSync
+		}), /* @__PURE__ */ jsx(Panel.Content, {
+			asChild: true,
+			children: /* @__PURE__ */ jsx(PostStack, {
+				id: subscription?.id ?? subject.id,
+				posts,
+				currentId: currentPostId,
+				onAction: handleAction
+			})
+		})]
+	});
+};
+FeedArticle.displayName = "FeedArticle";
+//#endregion
+export { FeedArticle as default };
+
+//# sourceMappingURL=chunk-FeedArticle.mjs.map

package/dist/lib/chunk-FeedArticle.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-FeedArticle.mjs","names":[],"sources":["../../src/containers/FeedArticle/FeedToolbar.tsx","../../src/containers/FeedArticle/FeedArticle.tsx"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport React from 'react';\n\nimport { Panel } from '@dxos/react-ui';\nimport { Menu, MenuBuilder, useMenuBuilder } from '@dxos/react-ui-menu';\n\nimport { meta } from '#meta';\n\nexport type FeedToolbarProps = {\n  attendableId?: string;\n  onSync: () => void;\n};\n\n/**\n * Reactive feed toolbar built from the menu action-graph idiom: a single Sync action. Matches the\n * magazine/post toolbars; the feed's name is surfaced by the plank chrome, not duplicated here.\n */\nexport const FeedToolbar = ({ attendableId, onSync }: FeedToolbarProps) => {\n  const menuActions = useMenuBuilder(\n    () =>\n      MenuBuilder.make()\n        .action(\n          'sync',\n          {\n            label: ['sync-feed.label', { ns: meta.profile.key }],\n            icon: 'ph--arrows-clockwise--regular',\n            iconOnly: true,\n          },\n          onSync,\n        )\n        .build(),\n    [onSync],\n  );\n\n  return (\n    <Menu.Root {...menuActions} attendableId={attendableId}>\n      <Panel.Toolbar asChild>\n        <Menu.Toolbar />\n      </Panel.Toolbar>\n    </Menu.Root>\n  );\n};\n\nFeedToolbar.displayName = 'FeedToolbar';\n","//\n// Copyright 2025 DXOS.org\n//\n\nimport React, { useCallback, useState } from 'react';\n\nimport { useOperationInvoker } from '@dxos/app-framework/ui';\nimport { type AppSurface } from '@dxos/app-toolkit/ui';\nimport { Filter, Obj, Query, Ref, Scope } from '@dxos/echo';\nimport { useObject, useQuery } from '@dxos/echo-react';\nimport { Panel } from '@dxos/react-ui';\n\nimport { PostStack, type PostStackAction } from '#components';\nimport { meta } from '#meta';\nimport { FeedOperation } from '#types';\nimport { Subscription } from '#types';\n\nimport { FeedToolbar } from './FeedToolbar';\n\nexport type FeedArticleProps = AppSurface.ObjectArticleProps<Subscription.Subscription>;\n\nexport const FeedArticle = ({ role, subject, attendableId }: FeedArticleProps) => {\n  const { invokePromise } = useOperationInvoker();\n  const [currentPostId, setCurrentPostId] = useState<string>();\n  const [subscription] = useObject(subject);\n  // Subscribe to the backing queue via its Ref — `.target` alone does not re-render when the\n  // feed loads after navigation (same pitfall as plugin-inbox MailboxArticle).\n  const [postFeed] = useObject(subscription?.feed);\n  const db = Obj.getDatabase(subscription);\n  const posts = useQuery(\n    db,\n    postFeed\n      ? Query.select(Filter.type(Subscription.Post)).from(Scope.feed(Obj.getURI(postFeed)))\n      : Query.select(Filter.nothing()),\n  );\n\n  const handleAction = useCallback((action: PostStackAction) => {\n    if (action.type === 'current') {\n      setCurrentPostId(action.postId);\n    }\n  }, []);\n\n  const handleSync = useCallback(() => {\n    // Failures surface as a toast via `notify`; invokePromise resolves with `{ error }`, never throws.\n    void invokePromise(\n      FeedOperation.SyncFeed,\n      { feed: Ref.make(subject) },\n      {\n        spaceId: Obj.getDatabase(subject)?.spaceId,\n        notify: { error: ['sync-feed-error.title', { ns: meta.profile.key }] },\n      },\n    );\n  }, [subject, invokePromise]);\n\n  return (\n    <Panel.Root role={role} classNames='dx-document'>\n      <FeedToolbar attendableId={attendableId} onSync={handleSync} />\n      <Panel.Content asChild>\n        <PostStack\n          id={subscription?.id ?? subject.id}\n          posts={posts}\n          currentId={currentPostId}\n          onAction={handleAction}\n        />\n      </Panel.Content>\n    </Panel.Root>\n  );\n};\n\nFeedArticle.displayName = 'FeedArticle';\n"],"mappings":";;;;;;;;;;;;;;;AAoBA,IAAa,eAAe,EAAE,cAAc,aAA+B;CACzE,MAAM,cAAc,qBAEhB,YAAY,KAAK,CAAA,CACd,OACC,QACA;EACE,OAAO,CAAC,mBAAmB,EAAE,IAAI,KAAK,QAAQ,IAAI,CAAC;EACnD,MAAM;EACN,UAAU;CACZ,GACA,MACF,CAAA,CACC,MAAM,GACX,CAAC,MAAM,CACT;CAEA,OACE,oBAAC,KAAK,MAAN;EAAW,GAAI;EAA2B;YACxC,oBAAC,MAAM,SAAP;GAAe,SAAA;aACb,oBAAC,KAAK,SAAN,CAAe,CAAA;EACF,CAAA;CACN,CAAA;AAEf;AAEA,YAAY,cAAc;;;ACzB1B,IAAa,eAAe,EAAE,MAAM,SAAS,mBAAqC;CAChF,MAAM,EAAE,kBAAkB,oBAAoB;CAC9C,MAAM,CAAC,eAAe,oBAAoB,SAAiB;CAC3D,MAAM,CAAC,gBAAgB,UAAU,OAAO;CAGxC,MAAM,CAAC,YAAY,UAAU,cAAc,IAAI;CAE/C,MAAM,QAAQ,SADH,IAAI,YAAY,YAEzB,GACA,WACI,MAAM,OAAO,OAAO,KAAK,aAAa,IAAI,CAAC,CAAC,CAAC,KAAK,MAAM,KAAK,IAAI,OAAO,QAAQ,CAAC,CAAC,IAClF,MAAM,OAAO,OAAO,QAAQ,CAAC,CACnC;CAEA,MAAM,eAAe,aAAa,WAA4B;EAC5D,IAAI,OAAO,SAAS,WAClB,iBAAiB,OAAO,MAAM;CAElC,GAAG,CAAC,CAAC;CAEL,MAAM,aAAa,kBAAkB;EAEnC,cACE,cAAc,UACd,EAAE,MAAM,IAAI,KAAK,OAAO,EAAE,GAC1B;GACE,SAAS,IAAI,YAAY,OAAO,CAAC,EAAE;GACnC,QAAQ,EAAE,OAAO,CAAC,yBAAyB,EAAE,IAAI,KAAK,QAAQ,IAAI,CAAC,EAAE;EACvE,CACF;CACF,GAAG,CAAC,SAAS,aAAa,CAAC;CAE3B,OACE,qBAAC,MAAM,MAAP;EAAkB;EAAM,YAAW;YAAnC,CACE,oBAAC,aAAD;GAA2B;GAAc,QAAQ;EAAa,CAAA,GAC9D,oBAAC,MAAM,SAAP;GAAe,SAAA;aACb,oBAAC,WAAD;IACE,IAAI,cAAc,MAAM,QAAQ;IACzB;IACP,WAAW;IACX,UAAU;GACX,CAAA;EACY,CAAA,CACL;;AAEhB;AAEA,YAAY,cAAc"}

package/dist/lib/chunk-FeedProperties.mjs

@@ -0,0 +1,78 @@
+import { Filter, Obj, Query, Ref } from "@dxos/echo";
+import { Operation, Trigger } from "@dxos/compute";
+import { meta } from "#meta";
+import { GraphPath, LayoutOperation } from "@dxos/app-toolkit";
+import { FeedOperation } from "#types";
+import { useCallback, useMemo, useState } from "react";
+import { IconButton, Input, useTranslation } from "@dxos/react-ui";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { Form } from "@dxos/react-ui-form";
+import { useOperationInvoker } from "@dxos/app-framework/ui";
+import { useObject, useQuery } from "@dxos/echo-react";
+//#region src/containers/FeedProperties/FeedProperties.tsx
+var FeedProperties = ({ subject }) => {
+	const { t } = useTranslation(meta.profile.key);
+	const { invokePromise } = useOperationInvoker();
+	const db = useMemo(() => Obj.getDatabase(subject), [subject]);
+	const [pending, setPending] = useState(false);
+	const childTriggers = useQuery(db, Query.select(Filter.and(Filter.type(Trigger.Trigger), Filter.childOf(subject, { transitive: false }))).debugLabel("plugin-magazine.FeedProperties.syncTrigger"));
+	const syncTrigger = useMemo(() => childTriggers.find((trigger) => trigger.spec?.kind === "timer"), [childTriggers]);
+	const [syncEnabled, setSyncEnabled] = useObject(syncTrigger, "enabled");
+	const handleToggleSync = useCallback(async () => {
+		if (!db) return;
+		if (syncTrigger) {
+			setSyncEnabled((enabled) => !enabled);
+			return;
+		}
+		setPending(true);
+		try {
+			const operation = await ensureSyncFeedOperation(db);
+			db.add(Trigger.make({
+				[Obj.Parent]: subject,
+				enabled: true,
+				spec: Trigger.specTimer("*/5 * * * *"),
+				runnable: Ref.make(operation),
+				input: { feed: db.makeRef(Obj.getURI(subject)) }
+			}));
+		} finally {
+			setPending(false);
+		}
+	}, [
+		syncTrigger,
+		db,
+		subject,
+		setSyncEnabled
+	]);
+	const handleViewTrigger = useCallback(() => {
+		if (!db) return;
+		invokePromise(LayoutOperation.Open, {
+			subject: [GraphPath.getSpacePath(db.spaceId, "settings", "org.dxos.plugin.routine.routines")],
+			workspace: GraphPath.getSpacePath(db.spaceId)
+		});
+	}, [invokePromise, db]);
+	return /* @__PURE__ */ jsx(Form.Section, { children: /* @__PURE__ */ jsxs(Input.Root, { children: [/* @__PURE__ */ jsx(Input.Label, { children: t("feed-sync.label") }), /* @__PURE__ */ jsxs("div", {
+		className: "flex flex-row items-center",
+		children: [/* @__PURE__ */ jsx(Input.Switch, {
+			checked: syncEnabled ?? false,
+			disabled: pending,
+			onCheckedChange: () => {
+				handleToggleSync();
+			}
+		}), syncTrigger && /* @__PURE__ */ jsx(IconButton, {
+			iconOnly: true,
+			icon: "ph--gear--regular",
+			label: t("view-trigger.label"),
+			onClick: handleViewTrigger
+		})]
+	})] }) });
+};
+var ensureSyncFeedOperation = async (db) => {
+	const [existingOperation] = await db.query(Filter.and(Filter.type(Operation.PersistentOperation), Filter.key(FeedOperation.SyncFeed.meta.key))).run();
+	if (existingOperation) return existingOperation;
+	return db.add(Operation.serialize(FeedOperation.SyncFeed));
+};
+FeedProperties.displayName = "FeedProperties";
+//#endregion
+export { FeedProperties as default };
+
+//# sourceMappingURL=chunk-FeedProperties.mjs.map

package/dist/lib/chunk-FeedProperties.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-FeedProperties.mjs","names":[],"sources":["../../src/containers/FeedProperties/FeedProperties.tsx"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport React, { useCallback, useMemo, useState } from 'react';\n\nimport { useOperationInvoker } from '@dxos/app-framework/ui';\nimport { GraphPath, LayoutOperation } from '@dxos/app-toolkit';\nimport { type AppSurface } from '@dxos/app-toolkit/ui';\nimport { Operation, Trigger } from '@dxos/compute';\nimport { Filter, Obj, Query, Ref } from '@dxos/echo';\nimport { useObject, useQuery } from '@dxos/echo-react';\nimport { IconButton, Input, useTranslation } from '@dxos/react-ui';\nimport { Form } from '@dxos/react-ui-form';\n\nimport { meta } from '#meta';\nimport { FeedOperation, Subscription } from '#types';\n\nexport type FeedPropertiesProps = AppSurface.ObjectPropertiesProps<Subscription.Subscription>;\n\nexport const FeedProperties = ({ subject }: FeedPropertiesProps) => {\n  const { t } = useTranslation(meta.profile.key);\n  const { invokePromise } = useOperationInvoker();\n  const db = useMemo(() => Obj.getDatabase(subject), [subject]);\n  const [pending, setPending] = useState(false);\n\n  const childTriggers = useQuery(\n    db,\n    Query.select(Filter.and(Filter.type(Trigger.Trigger), Filter.childOf(subject, { transitive: false }))).debugLabel(\n      'plugin-magazine.FeedProperties.syncTrigger',\n    ),\n  );\n\n  const syncTrigger = useMemo(() => childTriggers.find((trigger) => trigger.spec?.kind === 'timer'), [childTriggers]);\n\n  const [syncEnabled, setSyncEnabled] = useObject(syncTrigger, 'enabled');\n\n  const handleToggleSync = useCallback(async () => {\n    if (!db) {\n      return;\n    }\n\n    if (syncTrigger) {\n      setSyncEnabled((enabled) => !enabled);\n      return;\n    }\n\n    setPending(true);\n    try {\n      const operation = await ensureSyncFeedOperation(db);\n      db.add(\n        Trigger.make({\n          [Obj.Parent]: subject,\n          enabled: true,\n          spec: Trigger.specTimer('*/5 * * * *'),\n          runnable: Ref.make(operation),\n          input: { feed: db.makeRef(Obj.getURI(subject)) },\n        }),\n      );\n    } finally {\n      setPending(false);\n    }\n  }, [syncTrigger, db, subject, setSyncEnabled]);\n\n  const handleViewTrigger = useCallback(() => {\n    if (!db) {\n      return;\n    }\n\n    void invokePromise(LayoutOperation.Open, {\n      subject: [GraphPath.getSpacePath(db.spaceId, 'settings', 'org.dxos.plugin.routine.routines')],\n      workspace: GraphPath.getSpacePath(db.spaceId),\n    });\n  }, [invokePromise, db]);\n\n  return (\n    <Form.Section>\n      <Input.Root>\n        <Input.Label>{t('feed-sync.label')}</Input.Label>\n        <div className='flex flex-row items-center'>\n          <Input.Switch\n            checked={syncEnabled ?? false}\n            disabled={pending}\n            onCheckedChange={() => {\n              void handleToggleSync();\n            }}\n          />\n          {syncTrigger && (\n            <IconButton iconOnly icon='ph--gear--regular' label={t('view-trigger.label')} onClick={handleViewTrigger} />\n          )}\n        </div>\n      </Input.Root>\n    </Form.Section>\n  );\n};\n\nconst ensureSyncFeedOperation = async (db: NonNullable<ReturnType<typeof Obj.getDatabase>>) => {\n  const existing = await db\n    .query(Filter.and(Filter.type(Operation.PersistentOperation), Filter.key(FeedOperation.SyncFeed.meta.key)))\n    .run();\n  const [existingOperation] = existing;\n  if (existingOperation) {\n    return existingOperation;\n  }\n\n  return db.add(Operation.serialize(FeedOperation.SyncFeed));\n};\n\nFeedProperties.displayName = 'FeedProperties';\n"],"mappings":";;;;;;;;;;;;AAoBA,IAAa,kBAAkB,EAAE,cAAmC;CAClE,MAAM,EAAE,MAAM,eAAe,KAAK,QAAQ,GAAG;CAC7C,MAAM,EAAE,kBAAkB,oBAAoB;CAC9C,MAAM,KAAK,cAAc,IAAI,YAAY,OAAO,GAAG,CAAC,OAAO,CAAC;CAC5D,MAAM,CAAC,SAAS,cAAc,SAAS,KAAK;CAE5C,MAAM,gBAAgB,SACpB,IACA,MAAM,OAAO,OAAO,IAAI,OAAO,KAAK,QAAQ,OAAO,GAAG,OAAO,QAAQ,SAAS,EAAE,YAAY,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,WACrG,4CACF,CACF;CAEA,MAAM,cAAc,cAAc,cAAc,MAAM,YAAY,QAAQ,MAAM,SAAS,OAAO,GAAG,CAAC,aAAa,CAAC;CAElH,MAAM,CAAC,aAAa,kBAAkB,UAAU,aAAa,SAAS;CAEtE,MAAM,mBAAmB,YAAY,YAAY;EAC/C,IAAI,CAAC,IACH;EAGF,IAAI,aAAa;GACf,gBAAgB,YAAY,CAAC,OAAO;GACpC;EACF;EAEA,WAAW,IAAI;EACf,IAAI;GACF,MAAM,YAAY,MAAM,wBAAwB,EAAE;GAClD,GAAG,IACD,QAAQ,KAAK;KACV,IAAI,SAAS;IACd,SAAS;IACT,MAAM,QAAQ,UAAU,aAAa;IACrC,UAAU,IAAI,KAAK,SAAS;IAC5B,OAAO,EAAE,MAAM,GAAG,QAAQ,IAAI,OAAO,OAAO,CAAC,EAAE;GACjD,CAAC,CACH;EACF,UAAU;GACR,WAAW,KAAK;EAClB;CACF,GAAG;EAAC;EAAa;EAAI;EAAS;CAAc,CAAC;CAE7C,MAAM,oBAAoB,kBAAkB;EAC1C,IAAI,CAAC,IACH;EAGF,cAAmB,gBAAgB,MAAM;GACvC,SAAS,CAAC,UAAU,aAAa,GAAG,SAAS,YAAY,kCAAkC,CAAC;GAC5F,WAAW,UAAU,aAAa,GAAG,OAAO;EAC9C,CAAC;CACH,GAAG,CAAC,eAAe,EAAE,CAAC;CAEtB,OACE,oBAAC,KAAK,SAAN,EAAA,UACE,qBAAC,MAAM,MAAP,EAAA,UAAA,CACE,oBAAC,MAAM,OAAP,EAAA,UAAc,EAAE,iBAAiB,EAAe,CAAA,GAChD,qBAAC,OAAD;EAAK,WAAU;YAAf,CACE,oBAAC,MAAM,QAAP;GACE,SAAS,eAAe;GACxB,UAAU;GACV,uBAAuB;IACrB,iBAAsB;GACxB;EACD,CAAA,GACA,eACC,oBAAC,YAAD;GAAY,UAAA;GAAS,MAAK;GAAoB,OAAO,EAAE,oBAAoB;GAAG,SAAS;EAAoB,CAAA,CAE1G;GACK,EAAA,CAAA,EACA,CAAA;AAElB;AAEA,IAAM,0BAA0B,OAAO,OAAwD;CAI7F,MAAM,CAAC,qBAAqB,MAHL,GACpB,MAAM,OAAO,IAAI,OAAO,KAAK,UAAU,mBAAmB,GAAG,OAAO,IAAI,cAAc,SAAS,KAAK,GAAG,CAAC,CAAC,CAAA,CACzG,IAAI;CAEP,IAAI,mBACF,OAAO;CAGT,OAAO,GAAG,IAAI,UAAU,UAAU,cAAc,QAAQ,CAAC;AAC3D;AAEA,eAAe,cAAc"}