Skip to content

CubeLoop — a Pythonic, async-native agent harness core designed for high performance, readability, and production-grade persistence.

feat(agent)!: deferred_tool_strategy param, default dispatch

xf gong9505bac26fc4
diff --git a/cubepi/agent/agent.py b/cubepi/agent/agent.py
index b57a5bf..d94eb46 100644
--- a/cubepi/agent/agent.py
+++ b/cubepi/agent/agent.py
@@ -51,7 +51,7 @@ from cubepi.types import JsonObject, StructuredValue
TMessage = TypeVar("TMessage")
if TYPE_CHECKING:
- from cubepi.deferred.types import DeferredToolGroup
+ from cubepi.deferred.types import DeferredStrategy, DeferredToolGroup
from cubepi.providers.fallback import FallbackBoundModel
@@ -191,6 +191,7 @@ class Agent(Generic[TMessage]):
thread_id: str | None = None,
middleware: list[Middleware] | None = None,
deferred_tool_groups: list[DeferredToolGroup] | None = None,
+ deferred_tool_strategy: DeferredStrategy = "dispatch",
channel: HitlChannel | None = None,
messages: Sequence[Message] | None = None,
) -> None:
@@ -218,6 +219,7 @@ class Agent(Generic[TMessage]):
deferred_mw = DeferredToolsMiddleware(
groups=deferred_tool_groups,
extra_ref=lambda: self._extra,
+ strategy=deferred_tool_strategy,
on_tools_expanded=lambda new: self._state._tools.extend(
t for t in new if t.name not in {e.name for e in self._state._tools}
),
diff --git a/tests/deferred/test_agent_wiring.py b/tests/deferred/test_agent_wiring.py
index 8782550..33c1b0c 100644
--- a/tests/deferred/test_agent_wiring.py
+++ b/tests/deferred/test_agent_wiring.py
@@ -199,3 +199,33 @@ class TestForkOnceDeniesMiddlewareTools:
result = await denied.execute("call-1", _Empty())
assert result.is_error is True
assert "not available in a forked agent" in result.content[0].text
+
+
+class TestDeferredStrategyParam:
+ def test_default_strategy_is_dispatch(self) -> None:
+ model = _make_faux_model()
+ agent = Agent(
+ model=model,
+ deferred_tool_groups=[_make_group("g", ["t1"])],
+ )
+ names = [t.name for t in agent._state.tools]
+ assert "deferred_tool_call" in names
+
+ def test_inject_strategy_opt_in(self) -> None:
+ model = _make_faux_model()
+ agent = Agent(
+ model=model,
+ deferred_tool_groups=[_make_group("g", ["t1"])],
+ deferred_tool_strategy="inject",
+ )
+ names = [t.name for t in agent._state.tools]
+ assert "load_tools" in names
+ assert "deferred_tool_call" not in names
+
+ def test_resolve_hook_composed(self) -> None:
+ model = _make_faux_model()
+ agent = Agent(
+ model=model,
+ deferred_tool_groups=[_make_group("g", ["t1"])],
+ )
+ assert agent.resolve_tool_call is not None