Skip to content

docs(acp): Buzz relay-bridge (channels) integration guide (salvage #69915) - #73571

Merged
teknium1 merged 3 commits into
mainfrom
salvage/69915-buzz-relay-docs
Jul 29, 2026
Merged

docs(acp): Buzz relay-bridge (channels) integration guide (salvage #69915)#73571
teknium1 merged 3 commits into
mainfrom
salvage/69915-buzz-relay-docs

Conversation

@teknium1

Copy link
Copy Markdown
Contributor

Summary

The ACP docs now cover Buzz's second integration mode — joining Buzz channels via the buzz-acp relay bridge — alongside the Buzz Desktop managed-runtime section that landed in #73501, with both modes cross-linked.

Salvages the two commits from #69915 by @NYTEMODEONLY (authorship preserved), with every claim re-verified against block/buzz source and the unverifiable ones dropped.

Changes

  • website/docs/user-guide/features/acp.md: "Buzz channels (relay bridge)" host-setup section — topology, key minting (buzz-admin generate-key/add-member), bridge env vars, channel-membership access boundary, BUZZ_ACP_RELAY_OBSERVER Activity-log telemetry, headless-permission security guidance; page retitled "ACP Host Integration" — @NYTEMODEONLY
  • Follow-up (ours): verified all env vars against crates/buzz-acp/src/config.rs and kind 24200 against docs/nips/NIP-AO.md; dropped a 404 upstream doc link, the relay-directory/External-agents card claims, and "bot role" phrasing; replaced key provisioning with the real buzz-admin flow; cross-linked relay bridge ⇄ Desktop sections; pointed the permission paragraph at the owner-only warning; added BUZZ_ACP_AGENT_OWNER respond gate
  • zh-Hans: full translation of the new section + page retitle

Validation

Result
npx docusaurus build SUCCESS (en + zh-Hans; only pre-existing WSL-page anchor warnings)
Env vars / event kinds all verified present in block/buzz source
Dropped claims hermes-agent-acp.md (404), relay-directory profile, External-agents walkthrough

Infographic

Buzz relay bridge docs

@github-actions

github-actions Bot commented Jul 28, 2026

Copy link
Copy Markdown
Contributor

૮ >ﻌ< ა ci review

ran on ad07941

ℹ️ Info

Desktop E2E visual evidence · View test artifacts · View job

1 visual diff.

inline evidence upload failed.

Failed to upload diff-665a0833239e-onboarding-overlay-diff.png with gh image (exit code 1): Error uploading /home/runner/work/_temp/e2e-evidence/diff-665a0833239e-onboarding-overlay-diff.png: step 0 (get upload token): uploadToken not found on repo page — do you have write access to NousResearch/hermes-agent? (or, if NousResearch enforces SAML SSO, authorize at https://github.com/orgs/NousResearch/sso)

NYTEMODEONLY and others added 3 commits July 28, 2026 14:18
Co-authored-by: nytemodeonly <contact@nytemode.com>
Signed-off-by: nytemodeonly <contact@nytemode.com>
Co-authored-by: nytemodeonly <contact@nytemode.com>
Signed-off-by: nytemodeonly <contact@nytemode.com>
…ink modes, add zh-Hans

Follow-up on the salvaged #69915 commits:
- verified env vars against block/buzz crates/buzz-acp/src/config.rs
  (BUZZ_RELAY_URL, BUZZ_PRIVATE_KEY, BUZZ_API_TOKEN, BUZZ_ACP_AGENT_COMMAND/
  ARGS, BUZZ_ACP_RELAY_OBSERVER, BUZZ_ACP_AGENT_OWNER) and kind 24200
  observer frames against docs/nips/NIP-AO.md
- dropped unverifiable claims: docs/hermes-agent-acp.md link (404 upstream),
  relay-directory profile publication / External-agents card walkthrough,
  'bot role' membership phrasing
- replaced key provisioning with the actual buzz-admin generate-key /
  add-member flow from the buzz-acp README
- retitled the section 'Buzz channels (relay bridge)' and cross-linked it
  with the Buzz Desktop managed-runtime section both ways; permission
  paragraph now points at the owner-only warning instead of duplicating it
- zh-Hans translation of the new section + retitle to ACP 宿主集成
@teknium1
teknium1 force-pushed the salvage/69915-buzz-relay-docs branch from f887cd7 to ad07941 Compare July 28, 2026 21:18
@teknium1
teknium1 merged commit 82ed4de into main Jul 29, 2026
36 checks passed
@teknium1
teknium1 deleted the salvage/69915-buzz-relay-docs branch July 29, 2026 00:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

comp/acp Agent Communication Protocol adapter P3 Low — cosmetic, nice to have type/docs Documentation improvements

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants