Repository navigation
Remote ACP agents (channel role 'bot') do not appear in Desktop @mentions autocomplete dropdown #7222
Description
Activity
Update & Workaround / Resolution Found
After deeper investigation into the codebase (
desktop/src-tauri/src/nostr_convert/agent_directory.rsandagentAutocompleteEligibility.ts), we identified why remote server-hosted agents disappear from the@mentions picker and how to properly configure them:1. The Keyring Error when Adding to Local
managed-agents.jsonAttempting to manually register a remote agent into the client-side
%APPDATA%/.../agents/managed-agents.jsoncauses Buzz Desktop to treat the agent as a local desktop child process. When a user selects the mention chip, Desktop tries to spawn a local daemon and queries the OS Keyring (Windows Credential Manager) for itsnsecprivate key, failing with:
agent <pubkey> has no private key available — the OS keyring may be unreachable.2. The Native Remote Solution: Publishing Kind 10100 & Kind 30177
Buzz Desktop (0.5.12+) checks
relay_agents_from_directory_eventsandrelayAgentCanRespondInChannelusing two Nostr protocol events:kind: 10100(Agent Directory Profile): Authored and signed by the agent's pubkey, containing:{ "name": "Captain", "display_name": "Captain", "channel_add_policy": "open", "respond_to": "anyone", "respond_to_allowlist": [], "channels": ["<channel-uuid>", ...], "channel_ids": ["<channel-uuid>", ...] }kind: 30177(Managed Agent Directory Coordinate): Specifying agent parameter coordinates (name,parallelism,respond_to).
Once
kind: 10100andkind: 30177are published to the relay:- Buzz Desktop instantly indexes the agent as an active, verified relay agent.
- Native
@mention autocomplete is immediately restored across all channels for all users without requiring any local runner on individual laptops.
We recommend having
buzz-acpautomatically reconcile and publish its completekind: 10100directory profile upon startup after channel discovery.jinwoo-pa commented
on Oct 10, 2026 More actionsAdditional reproduction on Buzz Desktop for Windows v0.5.28:
- A remote agent is a channel member with role
bot. Its profile resolves by both pubkey and display name, and it is not archived. - The same owner account can select and mention this agent in the iPhone app; the agent receives and responds to those mentions.
- On Windows, this agent initially appeared in the thread composer’s
@picker and responded during a short collaboration test. Later, selecting it produced: “Could not authorize a mentioned agent. Check its access and channel membership, then retry or remove the mention.” - After restarting Desktop, the agent remained in the channel member list but disappeared from the thread composer’s
@search. Other agents in the same channel are still searchable and mentionable on Windows. Restarting did not restore this agent to the picker.
Expected: An eligible channel agent that can be mentioned from iPhone should also appear in the Windows Desktop picker.
This resembles #7222, but the initial success, subsequent authorization warning, and single-agent impact may indicate an additional state or authorization condition. I have not verified this agent’s kind:10100 or kind:30177 directory records, so I cannot confirm whether the workaround in the existing comment applies.
- A remote agent is a channel member with role
jinwoo-pa commented
on Oct 10, 2026 More actionsFollow-up to my earlier report (#issuecomment-6101990330) on Windows Buzz Desktop v0.5.28:
After leaving the app overnight and opening Windows Buzz again the next morning, the previously missing remote agent reappeared in the channel thread's @-mention picker.
However, selecting the agent immediately triggers the same authorization warning before I send any message:
Could not authorize a mentioned agent. Check its access and channel membership, then retry or remove the mention.
So the picker visibility issue is intermittent, but the authorization failure persists at mention-selection time. The agent was previously confirmed as an online channel
bot/relay member and can be mentioned and respond from iPhone. Other remote agents remain mentionable on Windows.This may help distinguish mention candidate discovery/cache refresh from the subsequent authorization check. I have not determined whether the rejection occurs locally or at the Relay, and have not changed any credentials, membership, or service settings.
jinwoo-pa commented
on Oct 11, 2026 More actionsAdditional finding (2026-10-11): affected remote agent appears as People, not Agent, in Windows "Add people and agents"
Following my earlier Windows v0.5.28 reports, I found a more specific UI inconsistency affecting only the remote server-hosted Codex agent named 검증 (verification).
Observed behavior
- In the Windows Desktop "Add people and agents" picker for another channel, four other server-hosted Codex teammates are labeled Agent, while 검증 alone appears under/as People.
- Adding 검증 to that new test channel does not make it respond there, on either Windows or iPhone.
- By contrast, 검증 still responds normally to @mentions from iPhone in its original collaboration channel.
- In the original channel on Windows, its @mention autocomplete visibility has been intermittent; when selectable, it has also produced the pre-send error: "Could not authorize a mentioned agent. Check its access and channel membership, then retry or remove the mention."
- A read-only server check confirmed that 검증 has channel role
botin the original channel, as do the other compared teammates. Its local manifest pubkey matched the relay profile/channel roster. A profile lookup succeeds, and the checked archive snapshot did not include this agent.
Read-only code investigation by our server-side team (source checkout
8af2d91f3, dated 2026-10-02; not yet verified identical to the installed Windows Desktop build):- The add-member search row's Agent/People label follows
user.isAgent:desktop/src/features/channels/ui/AddMemberSearchResultRow.tsx. MembersSidebar.tsxcombines kind:0 user search,list_relay_agents, andlist_managed_agents; matching pubkeys are merged, withisAgentcombined by OR.- The kind:0 user-search path uses validated NIP-OA ownership/auth tags to set
is_agent:desktop/src-tauri/src/nostr_convert/user_search.rs. - Relay-agent discovery involves agent directory/coordinate events and channel membership, whereas mention eligibility independently checks response policy, allowlists/owner, and channel sharing. Thus a
botchannel role alone does not guarantee an Agent label in this picker, and the mention-authorization failure is not yet proven to have the same root cause. - Possible explanation from this code: if the agent is present through the user-profile search as
isAgent=false, but absent from the resolved relay/local agent catalogs, it can appear as People. This is a hypothesis, not a confirmed missing event or bad registration.
Not yet verified: the affected and working agents' latest kind:0 NIP-OA auth tags, kind:10100 / kind:30177 events, the installed Windows client's actual
list_relay_agentsoutput andisAgentstate, or whether the new channel is in the agent's effective listening/response scope. The read-only relay event request was rejected withauth-required. The investigated source checkout may differ from the installed v0.5.28 UI.Questions for maintainers
- Could an agent whose existing channel membership is
botbe shown as People because NIP-OA verification or relay-agent catalog lookup fails or is stale? - Could this same identity/discovery inconsistency contribute to the pre-send mention authorization error, or are the two code paths independent?
- Which safe, read-only Windows Desktop diagnostics would reveal the underlying
isAgent,list_relay_agents, and mention-eligibility decisions?
We have not changed agent registrations, credentials, ACLs, channel permissions, or services. We would prefer to preserve the agent's working original channel while narrowing down the cause.
Screenshot evidence: One remote Codex agent is classified differently
The attached screenshot shows the Channel members → Add people and agents search results in Buzz Desktop for Windows v0.5.28.
All five remote Codex agents appear in the same search results, but they are classified differently:
- 코덱스 검증 (Verification): No
agentbadge — appears as a regular person. - 코덱스 리드 (Lead):
agentbadge displayed. - 코덱스 리서치 (Research):
agentbadge displayed. - 코덱스 설계 (Design):
agentbadge displayed. - 코덱스 코드·기술 (Code/Technical):
agentbadge displayed.
The affected Verification agent is registered with the
botrole in its original collaboration channel and responds successfully to mentions from the iPhone app in that channel.However, Windows Desktop intermittently fails to recognize or authorize this agent for mentions. It also does not respond in a newly added test channel on either Windows or iPhone.
This screenshot provides visible evidence of an agent-classification inconsistency. The exact relationship between the missing
agentbadge, the mention authorization error, and the new-channel response failure remains unconfirmed.Please see my earlier investigation comment for the relevant source-code paths and diagnostic findings.

- 코덱스 검증 (Verification): No
Remote ACP agents (channel role 'bot') do not appear in Desktop @mentions autocomplete dropdown
Summary
When an ACP agent is hosted remotely (e.g., running
buzz-acpon a server or VPS) and joined to a community channel withrole: "bot", human developers using Buzz Desktop cannot find or autocomplete the agent when typing@in the channel chat.While typing
@AgentNamemanually sends the message, the UI dropdown never lists the remote agent. This causes confusion for team members, making remote server agents appear non-mentionable or offline.Environment
buzz-acprunning on a remote Linux server connecting to a community relay (wss://...)role: "bot"in the channel.Root Cause Analysis
Inspection of the Desktop UI client logic (
managed_agents,change_channel_member_role, and mention suggestion filters) reveals the following split:@mention autocomplete generator queries channel members but filters out any identity whererole === "bot".managed_agents/custom_harnesses, but this only includes agents that have a local harness configuration present on that individual developer's machine.role: "bot"on the relay and has no local harness on the developer's machine. Consequently, it is excluded from both the human member list and the local agent list in the@autocomplete dropdown.role: "bot", so a channel owner cannot reassign the bot torole: "member"through the UI.Steps to Reproduce
buzz-acpconnected to a Buzz community relay.#generalwithrole: "bot".#generaland type@.owner,admin,member) appear in the suggestion dropdown, but the remote bot does not appear even when typing its full name.Expected Behavior
Any channel member (including identities with
role: "bot") or remote community agent should appear in the@autocomplete dropdown (ideally with a[Bot]or[Agent]badge), allowing any developer to easily discover and mention them without needing a local harness.Proposed Solutions
role: "bot"in Mention Suggestions: Update the channel mention suggestion filter in Desktop so that channel members withrole: "bot"are included alongside human members.