Skip to content

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

feat(agent): AgentTool.expose_to_model controls provider payload visibility

xf gong4e02dde3db06
diff --git a/cubepi/agent/loop.py b/cubepi/agent/loop.py
index 1171505..1f8696c 100644
--- a/cubepi/agent/loop.py
+++ b/cubepi/agent/loop.py
@@ -704,7 +704,9 @@ async def _stream_assistant_response(
tools_defs = None
if context.tools:
- tools_defs = [t.to_definition() for t in context.tools]
+ visible = [t for t in context.tools if t.expose_to_model]
+ if visible:
+ tools_defs = [t.to_definition() for t in visible]
sp = context.system_prompt
if transform_system_prompt:
diff --git a/cubepi/agent/types.py b/cubepi/agent/types.py
index 5eacc6b..5b1922b 100644
--- a/cubepi/agent/types.py
+++ b/cubepi/agent/types.py
@@ -40,6 +40,9 @@ class AgentTool(Generic[TParams]):
execution_mode: Literal["sequential", "parallel"] | None = None
hitl_builtin: bool = False
hitl: HitlBinding | None = None
+ # When False the tool is resolvable/executable by the engine but its
+ # definition is never sent to the provider (deferred dispatch mode).
+ expose_to_model: bool = True
def to_definition(self) -> ToolDefinition:
schema = self.parameters.model_json_schema()
diff --git a/tests/deferred/test_dispatch.py b/tests/deferred/test_dispatch.py
new file mode 100644
index 0000000..642faca
--- /dev/null
+++ b/tests/deferred/test_dispatch.py
@@ -0,0 +1,37 @@
+from __future__ import annotations
+
+from pydantic import BaseModel
+
+from cubepi.agent.types import AgentTool, AgentToolResult
+from cubepi.providers.base import TextContent
+
+
+class _Empty(BaseModel):
+ pass
+
+
+def _dummy_tool(name: str, *, expose: bool = True) -> AgentTool:
+ async def _exec(tool_call_id, args, *, signal=None, on_update=None):
+ return AgentToolResult(content=[TextContent(text="ok")])
+
+ return AgentTool(
+ name=name,
+ description="dummy",
+ parameters=_Empty,
+ execute=_exec,
+ expose_to_model=expose,
+ )
+
+
+class TestExposeToModel:
+ def test_default_is_true(self) -> None:
+ async def _exec(tool_call_id, args, *, signal=None, on_update=None):
+ return AgentToolResult(content=[TextContent(text="ok")])
+
+ tool = AgentTool(name="t", description="d", parameters=_Empty, execute=_exec)
+ assert tool.expose_to_model is True
+
+ def test_hidden_tool_excluded_from_payload_filter(self) -> None:
+ tools = [_dummy_tool("visible"), _dummy_tool("hidden", expose=False)]
+ visible = [t.to_definition() for t in tools if t.expose_to_model]
+ assert [d.name for d in visible] == ["visible"]