Skip to content

Commit abce149

Browse files
bostonaholicclaude
andcommitted
docs: the owner reviews a plugin request on a card in the conversation
Co-Authored-By: Claude Sonnet 5.5 <[email protected]> Signed-off-by: Matthew Boston <[email protected]>
1 parent e5ad369 commit abce149

4 files changed

Lines changed: 26 additions & 13 deletions

File tree

‎docs/agents.md‎

Lines changed: 13 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -135,13 +135,19 @@ once: it only stops code, and an enable request reverses it.
135135
`plugin_request` asks the person using Buzz to install, update, enable or remove a
136136
plugin and returns a request ID with `applied: false`. Install and update read the
137137
repository when the agent asks and pin the commit it saw, so the code reviewed is
138-
the code requested. The request appears under **Requested by agents** in
139-
**Settings → Plugins → Manage plugins**, with the agent's name and reason. Review
140-
opens the same access review as a [managed recommendation](managed-plugins.md) at
141-
that commit; enable shows the plugin's access; remove confirms like Delete. Decline
142-
refuses it, and closing a review leaves it pending. `plugin_request_status` tells
143-
only the requesting agent whether the request is pending, approved, declined or
144-
expired. Requests are local, at most 16 and one per plugin, and do not survive a
138+
the code requested. The tool also posts a message, signed as the agent, in the
139+
conversation the agent is working in, such as "Requested: install Browser — Open the
140+
staging site", and that message draws as a card with the plugin, the agent's name and
141+
reason, and **Review** and **Decline**. Review opens the same access review as a
142+
[managed recommendation](managed-plugins.md) at that commit; enable shows the
143+
plugin's access; remove confirms like Delete. Decline refuses it, and closing a review
144+
leaves it pending. Once decided, the card shows the outcome (such as Installed or
145+
Declined) without buttons. Only the device that holds the request shows the buttons;
146+
on another device, or after a restart, the card is the message alone. The request
147+
also stays under **Requested by agents** in **Settings → Plugins → Manage plugins**,
148+
for an agent with no conversation or a message that did not post.
149+
`plugin_request_status` tells only the requesting agent whether the request is
150+
pending, approved, declined or expired. Requests are local, at most 16 and one per plugin, and do not survive a
145151
restart. Agents cannot read Buzz-hosted repositories, since the desktop signs those
146152
reads as the owner; the owner adds them in Settings. A plugin listed in the
147153
[managed plugin file](managed-plugins.md) installs and updates only from its

‎docs/buzz-help.md‎

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -282,9 +282,10 @@ available rather than silently discarding it.
282282
offer; do not promise them.
283283
- Some desktop plugins can upload images you provide to services they declare.
284284
- In the desktop app, agents can list this device's plugins and disable one.
285-
Installing, updating, enabling or removing a plugin is a request: it waits under
286-
**Requested by agents** in **Settings → Plugins → Manage plugins** until the
287-
person reviews and confirms it, and a restart discards it. An agent cannot
285+
Installing, updating, enabling or removing a plugin is a request: the agent's
286+
message in the conversation shows a card with **Review** and **Decline**, and the
287+
change waits until the person reviews and confirms it there (or under **Requested
288+
by agents** in **Settings → Plugins → Manage plugins**). A restart discards it. An agent cannot
288289
install plugin code by itself.
289290
- **Attention**, when available, lets agents use Interests, watches, and timers
290291
to follow work. Its tab in an agent's profile shows what that agent is watching

‎docs/plugin-architecture.md‎

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1578,10 +1578,15 @@ work, including a voice call. This is a host-management capability, since an
15781578
external plugin cannot manage other installations or add CLI commands.
15791579
Agents reach management through the host's own tools: they read the catalog and
15801580
disable directly, and every install, update, enable or removal waits for the person
1581-
to confirm it; see [managing plugins from a conversation](agents.md#managing-plugins-from-a-conversation).
1581+
to confirm it on a card in the agent's conversation, or in Settings; see
1582+
[managing plugins from a conversation](agents.md#managing-plugins-from-a-conversation).
15821583
The request service is provided on the root context (`pluginRequests`) so agent
15831584
runs can reach it, which also makes it reachable from plugin scopes; plugins remain
1584-
trusted code.
1585+
trusted code. The card is a built-in feature (`buzz.plugin-requests`) that registers a
1586+
message renderer for messages with a `plugin-request` tag. Two services,
1587+
`pluginManagement` and `pluginReviewHold`, give the plugin manager and the open-review
1588+
hold to that feature alone, so asking cannot install or delete another plugin's code
1589+
without the review.
15851590

15861591
Opening an installed plugin's details checks its remembered folder. A matching
15871592
package shows Up to date in the pane. Local folders are checked every five seconds

‎src/buzz-mcp/AGENTS.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,8 @@ deliberately.
1414
owner's Buzz to run its workers; `solo-worker-protocol.ts` is their wire
1515
contract, pinned by `solo-worker-vectors.json`.
1616
- `plugins.ts`: the plugin tools (`plugin_*`), which read this device's plugins
17-
and ask the owner to change them; `src/plugins/requests.ts` owns the requests.
17+
and ask the owner to change them, which also posts the request's card message
18+
into the conversation; `src/plugins/requests.ts` owns the requests.
1819
- `session-tools.ts`: what a session lists, each tool's `load` (`always` or
1920
`search`), and the server instructions that cover the whole tool set.
2021
- `prompt.md`: the posting conventions every agent gets after the shared base

0 commit comments

Comments
 (0)