Zeren Wang 0d04322d41
feat(hitl): add human-in-the-loop approval for high-risk tool calls (#7979)
* feat(hitl): add human-in-the-loop approval for high-risk tool calls

* fix(hitl): address approval review findings

* docs(hitl): keep agent guidance under size limit

* fix(hitl): guard approval pause recovery

* docs(hitl): shrink inherited guidance

* fix(hitl): harden approval admission and recovery
2026-11-09 09:52:35 +08:00

60 lines
2.1 KiB
Python

"""Shared checkpoint-history traversal for partially asynchronous savers."""
from __future__ import annotations
import asyncio
from collections.abc import AsyncIterator
from typing import Any
async def recent_checkpoint_history(checkpointer: Any, read_config: dict[str, Any], *, limit: int = 20) -> AsyncIterator[Any]:
"""Yield checkpoints newest-first, degrading to the current tuple when needed.
``BaseCheckpointSaver`` exposes asynchronous methods even when a saver only
implements their synchronous counterparts. Each stage therefore treats
``NotImplementedError`` as a capability signal and moves to the next one.
Synchronous iteration and reads are kept off the event loop.
"""
if checkpointer is None:
return
async_history = getattr(checkpointer, "alist", None)
if callable(async_history):
try:
async for checkpoint_tuple in async_history(read_config, limit=limit):
yield checkpoint_tuple
return
except NotImplementedError:
pass
sync_history = getattr(checkpointer, "list", None)
if callable(sync_history):
try:
checkpoints = await asyncio.to_thread(lambda: list(sync_history(read_config, limit=limit)))
except NotImplementedError:
pass
else:
for checkpoint_tuple in checkpoints:
yield checkpoint_tuple
return
async_get_tuple = getattr(checkpointer, "aget_tuple", None)
if callable(async_get_tuple):
try:
checkpoint_tuple = await async_get_tuple(read_config)
except NotImplementedError:
pass
else:
if checkpoint_tuple is not None:
yield checkpoint_tuple
return
sync_get_tuple = getattr(checkpointer, "get_tuple", None)
if callable(sync_get_tuple):
try:
checkpoint_tuple = await asyncio.to_thread(sync_get_tuple, read_config)
except NotImplementedError:
return
if checkpoint_tuple is not None:
yield checkpoint_tuple