docs(cli): drop private references from the agent format comment (#8508)

### Why?

#8234 merged before its last review fix landed, so the `agent_event` doc
comment on main names a private repository and its internal class.
Public code should not reference private implementations.

### What?

Keeps the public pointer to buzz-app's MCP formatter and replaces the
private one with a generic note that other agent read surfaces trim the
same fields.

Signed-off-by: Nikolaj Goodger <ngoodger@squareup.com>
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
ngoodger-block
2026-10-23 14:48:13 +11:00
committed by GitHub
parent dc25198d53
commit 016310d3cc

View File

@@ -47,9 +47,9 @@ fn compact_event(event: &Value) -> Value {
/// markers into `reply_to`, plus `thread_root` for nested replies; every other
/// tag (channel, mentions, edit targets, diff provenance, ...) is kept verbatim.
///
/// Other agent read surfaces trim the same fields; change them together:
/// buzz-app's MCP (`src/buzz-mcp/tools.ts`, `Tools.messages`) and kgoose's
/// hosted read tools (squareup/cash-server `BuzzExtensionClient.messageJson`).
/// Other agent read surfaces trim the same fields, so change them together,
/// including buzz-app's MCP (block/buzz-app `src/buzz-mcp/tools.ts`,
/// `Tools.messages`).
fn agent_event(event: &Value) -> Value {
let raw_tags = event.get("tags").unwrap_or(&Value::Null);
let thread = thread_markers(raw_tags).resolve();