Grayscale/nanobot
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: add note about ephemeral guard and per-call hooks contextvar

Browse Source 
Document that SDK callers always go through run() → process_direct(ephemeral=False),
so per_call hooks are intentionally excluded from ephemeral turns per chengyongru
review feedback.
This commit is contained in:
michaelxer
2026-06-21 15:59:28 +08:00
committed by Xubin Ren
parent 345ef80571
commit a19725bc57
1 changed files with 4 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
nanobot/agent/loop.py
+4
View File
@@ -729,6 +729,10 @@ class AgentLoop:
hook: AgentHook = loop_hook hook: AgentHook = loop_hook
per_call = _per_call_hooks.get() per_call = _per_call_hooks.get()
extra_hooks = None extra_hooks = None
# NOTE: SDK callers always go through run() → process_direct(ephemeral=False),
# so per_call hooks are intentionally excluded from ephemeral turns. If a future
# caller sets the contextvar and then calls process_direct(ephemeral=True), the
# hooks will correctly NOT fire (ephemeral guard takes precedence).
if not ephemeral: if not ephemeral:
extra_hooks = per_call if per_call is not None else self._extra_hooks extra_hooks = per_call if per_call is not None else self._extra_hooks
if extra_hooks: if extra_hooks: