From d1b0fb6676872d6f6b6d1647ca44ffb09252a013 Mon Sep 17 00:00:00 2001 From: chengyongru Date: Mon, 1 Jun 2026 16:52:31 +0800 Subject: [PATCH] docs: clarify progress bus responsibility --- nanobot/bus/progress.py | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/nanobot/bus/progress.py b/nanobot/bus/progress.py index db9c4a653..d30b7ed79 100644 --- a/nanobot/bus/progress.py +++ b/nanobot/bus/progress.py @@ -1,4 +1,9 @@ -"""Progress callback helpers that publish through the message bus.""" +"""Progress callback helpers for user-visible output. + +These helpers convert agent progress callbacks into outbound chat messages. +Runtime state notifications such as turn lifecycle and model changes live in +``nanobot.bus.runtime_events``. +""" from __future__ import annotations @@ -13,7 +18,7 @@ def build_bus_progress_callback( bus: MessageBus, msg: InboundMessage, ) -> Callable[..., Awaitable[None]]: - """Return the bus progress callback for agent runtime events.""" + """Return a callback that publishes progress as outbound messages.""" async def _publish_progress( content: str,