CubeLoop — a Pythonic, async-native agent harness core designed for high performance, readability, and production-grade persistence.
Python agent-frameworkagent-harnessagent-runtimeagentic-aiai-agentsai-frameworkanthropicharnessharness-engineeringharness-frameworklanggraphlanggraph-alternativellmmcpopenaipi-agentpi-agent-corepythonpython-agent
feat(agent): AgentTool.expose_to_model controls provider payload visibility
xf gong4e02dde3db06
diff --git a/cubepi/agent/loop.py b/cubepi/agent/loop.pyindex 1171505..1f8696c 100644--- a/cubepi/agent/loop.py+++ b/cubepi/agent/loop.py@@ -704,7 +704,9 @@ async def _stream_assistant_response(tools_defs = Noneif 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_promptif transform_system_prompt:diff --git a/cubepi/agent/types.py b/cubepi/agent/types.pyindex 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 = Nonehitl_builtin: bool = Falsehitl: 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 = Truedef to_definition(self) -> ToolDefinition:schema = self.parameters.model_json_schema()diff --git a/tests/deferred/test_dispatch.py b/tests/deferred/test_dispatch.pynew file mode 100644index 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"]