Skip to content

feat(conversation): let plugin rows manage messages without visiting a channel #2512

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
kazemek21 wants to merge 3 commits into
base: main
Choose a base branch
from
+528 −27
Open

feat(conversation): let plugin rows manage messages without visiting a channel #2512

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
1d3c225
feat(conversation): let plugin rows manage messages without visiting …
kazemek21 Nov 4, 2026
1d721b8
test(conversation): cover the no-visit scope's roster hold and author…
kazemek21 Nov 4, 2026
1394bda
chore: rerun CI after main's test fixes (#2517)
kazemek21 Nov 4, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 17 additions & 1 deletion docs/plugin-architecture.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2022,7 +2022,7 @@ pinch, Ctrl/⌘-scroll, drag, double-click and keyboard and offers Copy code.
Invalid source shows Pele's error with the source.

The conversation preview exposes top-level `registerTool`, `registerCompletion` and `registerInline`
methods and stable `conversation.ui.Composer` / `.Message` / `.Thread` components, plus `.Tabs` while a plugin provides it. Generated
methods and stable `conversation.ui.Composer` / `.Message` / `.Thread` / `.Conversation` components, plus `.Tabs` while a plugin provides it. Generated
type-only `@buzz/author` declarations are exercised by a source-only external consumer
fixture in `tests/fixtures/conversation-consumer`; it is built and installed only in
the browser test's temporary profile.
Expand Down Expand Up @@ -2052,6 +2052,22 @@ that visit lasts across threads of the same channel. The page holds no second
message reader, cache or outbox.
Exact message links still navigate to Channels rather than the page's route.

`conversation.ui.Conversation({ session, scope, channelId, channelName?, threadId?, children })`
gives a page's own `ui.Message` rows and `ui.Composer` for one channel the host
behavior Channels rows have, without showing a thread or visiting the channel:
mounting it never marks anything read, follows a thread or holds the channel's
roster. `children(interactions)` receives the host's `onOpenLink`, `canOpenLink`
and `onOpenMediaReview` for those rows. Inside it, rows offer Edit and Delete
under the usual permissions; Edit fills the `ui.Composer` inside the same
`ui.Conversation` (pass the rows it may edit as `editMessages`), and a row has
no Edit without one. Delete asks for confirmation, and a failed edit or deletion
shows a notice to retry or discard it before `children`. Media review and
registered panels open over the page and stop opening once its session is no
longer the ready one. Render one `ui.Conversation` per channel or card, so each
card's edits and recovery stay its own; `threadId` keeps panels opened from a
card in that thread. Writes, mark read/unread and follow remain explicit menu
actions.

`conversation.ui.Tabs({ id, session, scope, label, icon, children })` makes the
page's content the first main tab of the host's conversation tab workspace.
`children(open, close, isOpen)` renders that tab; `open({ channelId, threadId?, messageId? }, { keep? })`
Expand Down
Loading
Loading